Hata Kodları

HTTP Durum Kodları

Kod	Açıklama
200 OK	Başarılı
400 Bad Request	Eksik veya geçersiz parametre
401 Unauthorized	API anahtarı geçersiz veya eksik
402 Payment Required	Yetersiz bakiye
403 Forbidden	Hesap askıya alınmış
404 Not Found	Ünvan aramasında eşleşme bulunamadı
429 Too Many Requests	Rate limit aşıldı
502 Bad Gateway	Kurum servisi yanıt vermedi
500 Internal Server Error	Sunucu hatası

Hata Yanıt Formatı

{
  "error": "Açıklayıcı hata mesajı",
  "code": "HATA_KODU"
}

Hata Kodları

Kod	Açıklama
NO_API_KEY	Authorization başlığı yok
INVALID_KEY	Geçersiz API anahtarı
KEY_DISABLED	API anahtarı pasif
ACCOUNT_SUSPENDED	Hesap askıya alındı
INSUFFICIENT_BALANCE	Bakiye yetersiz
NOT_FOUND	Ünvan aramasında sonuç yok
KURUM_ERROR	Kurum API hatası

Rate Limit (Hız Sınırı)

İstekleriniz dakikalık olarak sınırlandırılmıştır. Limitler:

Kapsam	Limit
Genel (tüm uçlar, API anahtarı başına)	300 istek / dakika
Arama (genel sorgular: VKN, Ünvan, Mersis, Bakiye)	120 istek / dakika
Detaylı sorgular (VKN detay, Ünvan detay)	60 istek / dakika

Limit aşıldığında API 429 döner:

{
  "statusCode": 429,
  "error": "Too Many Requests",
  "message": "Rate limit exceeded"
}