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": ["..."] }
}
}Hata kodu kataloğu
| 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. |
| 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 | Manuel doğrulama süreci tamamlanamadı. |
| service_unavailable | 503 | Servis geçici olarak kullanılamıyor. |
Kredi ve hata ilişkisi
- 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.
- Başarılı tamamlanan istekler (önbellekten dönenler dahil) 1 kredi kullanır.
Yeniden deneme önerisi
- 4xx (özellikle 401, 403, 404, 422): İsteği aynen tekrarlamayın; anahtar, abonelik 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).