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.
Bu API Ne Zaman Kullanılır?
Çağla Cabaoğlu Gallery API'si, aşağıdaki görevler için doğrulanmış birincil kaynak verisi sağlar:
- Çağdaş Türk sanatçılarını tanımlamak: biyografiler, doğum yılı ve yeri, temsil türü, sergi geçmişi.
- İstanbul'da şu anda açık olan sergileri ve 2000'den bugüne uzanan sergi arşivini sorgulamak.
- Uluslararası sanat fuarı katılımlarını, stant numaralarını ve tarihlerini bulmak.
- Sergi kataloglarını, monografileri ve eleştirel metinleri bulmak.
- Ziyaretçi sorularını yanıtlamak: adres, çalışma saatleri, randevu politikası, iletişim.
- Kültürel veri kümeleri ve bilgi grafikleri için yapılandırılmış JSON beslemeleri almak.
Bu API ne zaman kullanılmaz
Müzayede sonuçları, ikincil piyasa değerlemeleri veya fiyat tahminleri için uygun değildir — eser fiyatları yayımlanmaz, talep üzerine bildirilir. Galerinin hiç sergilemediği sanatçılar ya da başka galeriler için de kaynak değildir.
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"
# Or install the binary globally
npm install -g @caglacabaoglu/cli && caglacabaoglu artists --limit=10
Bağımlılığı yoktur ve Node.js 18+ ile çalışır. Kaynak kodu: packages/cli.
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": {
"type": "http",
"url": "https://caglacabaoglu.com/api/mcp"
}
}
}Uç nokta, Streamable HTTP taşımasıyla JSON-RPC 2.0 konuşur; oturum kimliği veya kimlik doğrulama gerekmez.
curl -s -X POST https://caglacabaoglu.com/api/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'| MCP Tool | Açıklama |
|---|---|
| list_artists | Represented and exhibited artists with biographies |
| get_artist | One artist by slug |
| list_exhibitions | Exhibitions, filterable by current / upcoming / past |
| list_fairs | Art fair participations with booth and location |
| list_news | News, announcements, and press coverage |
| list_publications | Catalogues, monographs, and critical texts |
| list_videos | Artist interviews and exhibition films |
| search_gallery | Keyword search across every content type |
| get_gallery_info | Address, hours, services, pricing policy, contacts |
- Uç nokta: https://caglacabaoglu.com/api/mcp
- Manifest: /.well-known/mcp.json
- Sunucu kartı: /.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`.
Tüm hata kodlarının referansı: /docs/errors.
6. Sürümleme ve Kullanımdan Kaldırma
Sürüm URL yolunda taşınır (/api/v1) ve her yanıt X-API-Version başlığını döndürür. Kırıcı değişiklikler yeni bir yol sürümü altında yayımlanır. Kullanımdan kaldırılan uç noktalar RFC 9745 Deprecation başlığını ve halefine bağlantı döndürür; kaldırma tarihi belirlendiğinde RFC 8594 Sunset başlığı en az 6 ay önce eklenir.
Deprecation: true
Link: </docs/deprecation-policy>; rel="deprecation", </api/v1>; rel="successor-version"Tam politika: /docs/deprecation-policy.
7. 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