Çağla Cabaoğlu Gallery

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ı

CodeHTTPAnlamıNe yapmalı
NOT_FOUND404The requested endpoint or record does not existCheck /openapi.json for the endpoint list, or call /api/v1 for the endpoint index.
VALIDATION_FAILED400One or more request fields failed validationRead `detail` for the offending field and resend with a corrected payload.
MISSING_REQUIRED_FIELDS400A required field was absent from the request bodyCompare the payload with the request schema in /openapi.json.
INVALID_JSON400The request body is not valid JSONSend `Content-Type: application/json` with a well-formed JSON body.
QUERY_TOO_LONG400The search query exceeds the maximum lengthUse a query between 2 and 64 characters.
SEARCH_FAILED500The search index could not answer the queryRetry once after a short delay; if it persists, fall back to /api/v1/artists or /api/v1/exhibitions.
RATE_LIMITED429Too many requests for the free public tierHonour `Retry-After` and `RateLimit-Reset` (seconds). The free tier allows 120 requests/minute.
RATE_LIMIT_CONFIG_MISSING503Rate limiting is temporarily unavailableA server-side configuration issue. Retry later; do not treat it as a client error.
REGISTRATION_FAILED400Agent registration could not be completedVerify the registration payload documented at /openapi.json under registerAgentV1.
SUBMISSION_FAILED500The contact submission could not be deliveredRetry once, then email contactgallery@caglacabaoglu.com directly.
EMAIL_SERVICE_CONFIG_MISSING503The transactional email service is unavailableServer-side configuration issue. Retry later.
INTERNAL_ERROR500Unexpected server errorRetry with exponential backoff. Report persistent failures to contactgallery@caglacabaoglu.com.