Programatik Arayüz ve Yapay Zeka Ajanları

Çağla Cabaoğlu Gallery Developer Portal

Çağla Cabaoğlu Gallery, çağdaş sanatçı profilleri, sergi arşivleri, fuar katılımları ve yayın katalogları için yapay zeka ajanlarına ve geliştiricilere açık REST API, OpenAPI 3.1 spesifikasyonu ve Model Context Protocol (MCP) entegrasyonu sunar.

OpenAPI 3.1 Spec (JSON)llms.txt Summary llms-full.txt Complete

1. Ücretsiz Erişim ve Hızlı Başlangıç

Tüm okuma uç noktalarımız herkese açıktır. Herhangi bir kayıt veya API anahtarı olmadan dakikada 120 istek yapabilirsiniz. İstekler standart RFC 9110 RateLimit başlıkları döndürür.

# Query represented gallery artists
curl -s https://caglacabaoglu.com/api/v1/artists

# Query active and past exhibitions
curl -s https://caglacabaoglu.com/api/v1/exhibitions?status=current

# Fuzzy multilingual search
curl -s "https://caglacabaoglu.com/api/v1/search?q=Nadide+Akdeniz"

2. Resmi CLI Aracı

Komut satırından veya agent betiklerinden galeri verilerine anında erişmek için npm paketimizi çalıştırabilirsiniz:

# Run directly with npx (no install required)

npx @caglacabaoglu/cli artists

npx @caglacabaoglu/cli exhibitions --status=current

npx @caglacabaoglu/cli search "contemporary painting"

3. API Uç Noktaları Referansı (v1)

Method	Endpoint	Description	Operation ID
GET	/api/v1/artists	Represented artists with biographies and profile links	getArtistsV1
GET	/api/v1/exhibitions	Current, upcoming, and past exhibitions	getExhibitionsV1
GET	/api/v1/fairs	Art fairs with booth numbers and dates	getFairsV1
GET	/api/v1/news	Press releases and gallery announcements	getNewsV1
GET	/api/v1/publications	Exhibition catalogues and published books	getPublicationsV1
GET	/api/v1/videos	Artist interview and exhibition documentary videos	getVideosV1
GET	/api/v1/search	Multilingual fuzzy search (?q=query&locale=en)	searchGalleryV1
POST	/api/v1/agent/register	Programmatic agent registration for credentials	registerAgentV1
GET	/api/v1/agent/premium	Gated contemporary art monographs (x402 / Bearer)	getPremiumMonographsV1

4. Model Context Protocol (MCP) Entegrasyonu

Çağla Cabaoğlu Gallery, Claude Desktop, Cursor, Gemini ve Antigravity araçları için Model Context Protocol sunucusunu destekler.

{
  "mcpServers": {
    "caglacabaoglu": {
      "url": "https://caglacabaoglu.com/.well-known/mcp/server-card.json"
    }
  }
}

5. Hata Yönetimi ve Hız Sınırları (RFC 9457 & RFC 9110)

Tüm API hata yanıtları, yapay zeka ajanlarının kolayca ayrıştırabilmesi için RFC 9457 Problem Details formatında `type`, `title`, `status`, `detail`, `code` ve `hint` alanları ile döner.

{
  "type": "https://caglacabaoglu.com/docs/errors#QUERY_TOO_LONG",
  "title": "Query too long",
  "status": 400,
  "detail": "Query exceeds maximum length of 64 characters.",
  "code": "QUERY_TOO_LONG",
  "hint": "Please provide a query between 2 and 64 characters."
}

Hız sınırları yanıt başlıklarında iletilir: `RateLimit-Limit: 120`, `RateLimit-Remaining: 119`, `RateLimit-Reset: 60`.

6. Destek ve İletişim

API kullanımı, özel veri akışları veya kurumsal entegrasyonlar için lütfen iletişime geçin:

Email: contactgallery@caglacabaoglu.com
Phone: +90 212 291 37 91
Address: Zafer Sokak, Tarihi Manuel Apartmanı No:11-13 D:10 Kat:4, 34365 Nişantaşı-Şişli, Istanbul, Turkey
Contact Page: https://caglacabaoglu.com/tr/contact