Geliştirici Portalı
Çağla Cabaoğlu Gallery API Error Codes
Çağla Cabaoğlu Gallery REST API'si ve MCP sunucusu, tüm hataları RFC 9457 Problem Details biçiminde döndürür. Her hata belgesindeki `type` alanı bu sayfadaki ilgili bağlantıya işaret eder.
Hata Yanıtı Biçimi
{
"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."
}Content-Type: application/problem+json. Hız sınırı yanıtları ayrıca RateLimit-* ve Retry-After başlıklarını içerir.
Hata Kodları
| Code | HTTP | Anlamı | Ne yapmalı |
|---|---|---|---|
| NOT_FOUND | 404 | The requested endpoint or record does not exist | Check /openapi.json for the endpoint list, or call /api/v1 for the endpoint index. |
| VALIDATION_FAILED | 400 | One or more request fields failed validation | Read `detail` for the offending field and resend with a corrected payload. |
| MISSING_REQUIRED_FIELDS | 400 | A required field was absent from the request body | Compare the payload with the request schema in /openapi.json. |
| INVALID_JSON | 400 | The request body is not valid JSON | Send `Content-Type: application/json` with a well-formed JSON body. |
| QUERY_TOO_LONG | 400 | The search query exceeds the maximum length | Use a query between 2 and 64 characters. |
| SEARCH_FAILED | 500 | The search index could not answer the query | Retry once after a short delay; if it persists, fall back to /api/v1/artists or /api/v1/exhibitions. |
| RATE_LIMITED | 429 | Too many requests for the free public tier | Honour `Retry-After` and `RateLimit-Reset` (seconds). The free tier allows 120 requests/minute. |
| RATE_LIMIT_CONFIG_MISSING | 503 | Rate limiting is temporarily unavailable | A server-side configuration issue. Retry later; do not treat it as a client error. |
| REGISTRATION_FAILED | 400 | Agent registration could not be completed | Verify the registration payload documented at /openapi.json under registerAgentV1. |
| SUBMISSION_FAILED | 500 | The contact submission could not be delivered | Retry once, then email contactgallery@caglacabaoglu.com directly. |
| EMAIL_SERVICE_CONFIG_MISSING | 503 | The transactional email service is unavailable | Server-side configuration issue. Retry later. |
| INTERNAL_ERROR | 500 | Unexpected server error | Retry with exponential backoff. Report persistent failures to contactgallery@caglacabaoglu.com. |