Hatalar

Yanıt formatı

API hataları tek tip bir gövde kullanır. Doğrulama hatalarında details alanı alan bazlı mesajlar içerebilir.

{
  "error": {
    "code": "validation_error",
    "message": "Gönderilen veriler geçersiz.",
    "details": { "id_number": ["..."] }
  }
}

Kod	HTTP	Açıklama
validation_error	400 / 422	İstek gövdesi veya parametreler şemaya uymuyor. Kredi rezervasyonu yapılmaz.
invalid_tc_kimlik	400	T.C. kimlik numarası biçim veya checksum açısından geçersiz. Kredi düşülmez.
unauthorized	401	API anahtarı eksik veya hatalı.
insufficient_credits	402	Yetersiz kredi.
billing_setup_required	402	Aboneliği olmayan hesap ücretsiz production kredilerini kullanmak için panelden fatura bilgilerini tamamlayıp kart eklemelidir. Kredi düşülmez.
forbidden	403	Genel yetki reddi.
email_unverified	403	Hesap e-posta adresi doğrulanmadan API kullanılamaz.
no_active_subscription	403	Production doğrulama için aktif abonelik yok.
subscription_suspended	403	Abonelik askıda.
app_inactive	403	Uygulama devre dışı.
request_not_found	404	İstek ID bu uygulamaya ait değil veya yok.
verification_error	500	Doğrulama süreci tamamlanamadı.
service_unavailable	503	Servis geçici olarak kullanılamıyor. Yanıtta `Retry-After` başlığı varsa en az o kadar saniye bekleyin.

4xx doğrulama/validation hatalarında kredi rezervasyonu yapılmaz veya iade edilir.
500 / 503 işlem veya servis hatalarında rezerve edilen kredi iade edilir.
Kredi yalnızca bilgilerin eşleşip eşleşmediği belirlenen (verified true veya false) istekler için düşer; önbellekten dönen sonuçlar dahil 1 kredi kullanır.
İşlenmekte olan (processing) istekler için kredi ayrılmış kalır; sonuç üretilemezse istek failed olur ve kredi iade edilir.

4xx (özellikle 401, 402, 403, 404, 422): İsteği aynen tekrarlamayın; anahtar, abonelik, kredi veya gövdeyi düzeltin.
500 / 503: Geçici arıza olabilir; üstel geri çekilme ile sınırlı sayıda yeniden deneyin ve idempotency ihtiyacını göz önünde bulundurun (API şu anda idempotency key desteği sunmamaktadır).
Uzun süren işlem: processing bir hata değildir. Sonucu beklerken aynı bilgilerle yeni istek göndermeyin; her istek ayrı değerlendirilir ve sonuç üretirse ayrı ücretlendirilir.
Retry-After: 503 yanıtında bu başlık varsa, kaynak servis geçici olarak istekleri engelliyor demektir. Belirtilen saniye dolmadan tekrar denemeyin; bu süre içindeki istekler beklemeden reddedilir ve kredi düşülmez.