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" }
}| Alan | Tip | Açıklama |
|---|---|---|
error.code | string | Makine-okur kod (aşağıdaki katalog) |
error.message | string | Türkçe açıklama |
error.details | array | Yalnızca VALIDATION_ERROR: alan bazlı sorunlar (path, code, message) |
error.retryAfter | integer | Yalnızca 429: kaç saniye sonra denenmeli |
meta.requestId | string | req_ 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
| Kod | Açıklama |
|---|---|
VALIDATION_ERROR | Parametre eksik ya da geçersiz; details alanına bakın |
BILLING_DETAILS_REQUIRED | Planınız için fatura bilgileri tamamlanmalı |
401
| Kod | Açıklama |
|---|---|
API_KEY_REQUIRED | Authorization başlığı yok |
API_KEY_INVALID | Anahtar biçimi bozuk ya da tanınmıyor |
API_KEY_REVOKED | Anahtar iptal edilmiş |
API_KEY_EXPIRED | Anahtarın süresi dolmuş |
403
| Kod | Açıklama |
|---|---|
API_ACCESS_NOT_IN_PLAN | Mevcut plan API erişimi içermiyor |
SCOPE_REQUIRED | Anahtar bu uç için gereken yetkiye sahip değil |
MODULE_NOT_IN_PLAN | Uç, aboneliğe dahil olmayan bir modül gerektiriyor |
FEATURE_NOT_IN_PLAN | Uç, 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) |
FORBIDDEN | Genel yetki hatası |
404
| Kod | Açıklama |
|---|---|
NOT_FOUND | Sembol ya da kayıt bulunamadı (örn. /v1/symbols/XXXXX) |
405, 413, 415
| Kod | Açıklama |
|---|---|
METHOD_NOT_ALLOWED | Uç bu HTTP yöntemini desteklemiyor |
PAYLOAD_TOO_LARGE | İstek gövdesi 1 MB sınırını aşıyor |
UNSUPPORTED_MEDIA_TYPE | Desteklenmeyen içerik türü |
429
| Kod | Açıklama |
|---|---|
RATE_LIMITED | Dakikalık ya da IP limiti aşıldı |
QUOTA_EXCEEDED | Günlük kota doldu |
Ayrıntı: Limitler.
5xx
| Kod | HTTP | Açıklama |
|---|---|---|
INTERNAL_ERROR | 500 | Beklenmeyen hata; requestId ile bildirin |
SERVICE_UNAVAILABLE | 503 | Servis geçici olarak kullanılamıyor |
MAINTENANCE | 503 | Planlı bakım; Retry-After sonra deneyin |
REQUEST_TIMEOUT | 504 | İstek 15 saniyede tamamlanamadı |
İstemci tarafında öneriler
- Önce HTTP durumuna, sonra
error.codedeğerine göre dallanın;messagemetnini eşleştirmeyin. - 429 ve 503 için
Retry-Afterdeğerine saygı göstererek yeniden deneyin; 4xx'lerin geri kalanında yeniden deneme yapmayın. - Loglarınıza
meta.requestIddeğerini yazın.