İçeriğe geç

Hatalar

Hata zarfı, X-Request-Id ve hata kodu kataloğu.

Hata zarfı

Her hata aynı biçimde döner. HTTP durum kodu gövdede tekrarlanmaz; programatik ayrım için error.code kullanın. error.message Türkçe, kullanıcıya gösterilebilir bir metindir ve değişebilir; error.code sabittir.

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Gönderilen bilgiler geçersiz",
    "details": [
      { "path": "interval", "code": "invalid_value", "message": "Geçersiz interval (geçerli: 1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w, 1mo)" }
    ]
  },
  "meta": { "requestId": "req_01jzqk4x8m9b2c5d7e8f9g0h1j" }
}
AlanTipAçıklama
error.codestringMakine-okur kod (aşağıdaki katalog)
error.messagestringTürkçe açıklama
error.detailsarrayYalnızca VALIDATION_ERROR: alan bazlı sorunlar (path, code, message)
error.retryAfterintegerYalnızca 429: kaç saniye sonra denenmeli
meta.requestIdstringreq_ ile başlayan istek kimliği; X-Request-Id başlığıyla aynı

Her yanıt (başarılı ya da hatalı) X-Request-Id başlığı taşır. Destek taleplerinde bu değeri paylaşın.

Kod kataloğu

400

KodAçıklama
VALIDATION_ERRORParametre eksik ya da geçersiz; details alanına bakın
BILLING_DETAILS_REQUIREDPlanınız için fatura bilgileri tamamlanmalı

401

KodAçıklama
API_KEY_REQUIREDAuthorization başlığı yok
API_KEY_INVALIDAnahtar biçimi bozuk ya da tanınmıyor
API_KEY_REVOKEDAnahtar iptal edilmiş
API_KEY_EXPIREDAnahtarın süresi dolmuş

403

KodAçıklama
API_ACCESS_NOT_IN_PLANMevcut plan API erişimi içermiyor
SCOPE_REQUIREDAnahtar bu uç için gereken yetkiye sahip değil
MODULE_NOT_IN_PLANUç, aboneliğe dahil olmayan bir modül gerektiriyor
FEATURE_NOT_IN_PLANUç, planda bulunmayan bir özellik gerektiriyor
PLAN_LIMIT_EXCEEDEDİstek plan sınırını aşıyor (sembol sayısı, gün içi geçmiş, backtest)
FORBIDDENGenel yetki hatası

404

KodAçıklama
NOT_FOUNDSembol ya da kayıt bulunamadı (örn. /v1/symbols/XXXXX)

405, 413, 415

KodAçıklama
METHOD_NOT_ALLOWEDUç bu HTTP yöntemini desteklemiyor
PAYLOAD_TOO_LARGEİstek gövdesi 1 MB sınırını aşıyor
UNSUPPORTED_MEDIA_TYPEDesteklenmeyen içerik türü

429

KodAçıklama
RATE_LIMITEDDakikalık ya da IP limiti aşıldı
QUOTA_EXCEEDEDGünlük kota doldu

Ayrıntı: Limitler.

5xx

KodHTTPAçıklama
INTERNAL_ERROR500Beklenmeyen hata; requestId ile bildirin
SERVICE_UNAVAILABLE503Servis geçici olarak kullanılamıyor
MAINTENANCE503Planlı bakım; Retry-After sonra deneyin
REQUEST_TIMEOUT504İstek 15 saniyede tamamlanamadı

İstemci tarafında öneriler

  • Önce HTTP durumuna, sonra error.code değerine göre dallanın; message metnini eşleştirmeyin.
  • 429 ve 503 için Retry-After değerine saygı göstererek yeniden deneyin; 4xx'lerin geri kalanında yeniden deneme yapmayın.
  • Loglarınıza meta.requestId değerini yazın.

Bu sayfada