Hata Yönetimi

Tüm API hataları tutarlı bir formatta döner. Bunları sorunsuz şekilde nasıl ele alacağınızı burada bulabilirsiniz.

Hata yanıtı formatı

Bir hata oluştuğunda API, şu yapıda bir JSON nesnesi döndürür:

json

{
  "error": "Validation Error",
  "message": "The email field is required.",
  "status_code": 422
}

Durum Kodu	Hata	Neden ve Çözüm
`400`	Hatalı İstek	Hatalı biçimlendirilmiş JSON veya eksik zorunlu alanlar. İstek gövdenizi kontrol edin.
`401`	Yetkisiz	API anahtarı eksik veya geçersiz. Şu başlığı kontrol edin: `Authorization` .
`402`	Ödeme Gerekli	Yetersiz kredi. Daha fazla kredi satın alın veya günlük limitin sıfırlanmasını bekleyin.
`422`	Doğrulama Hatası	E-posta adresi formatı geçersiz. Gönderdiğiniz değeri kontrol edin.
`429`	Çok Fazla İstek	İstek limiti aşıldı. Şu başlığı kontrol edin: `Retry-After` ve bekleyin.
`500`	Sunucu Hatası	Bizim tarafımızda bir sorun oluştu. Birkaç saniye içinde tekrar deneyin. Destek ekibiyle iletişime geçin sorun devam ederse.

json

{
  "error": "Unauthorized",
  "message": "Invalid or missing API key",
  "status_code": 401
}

Çözüm: Şu başlığın Authorization doğru biçimde şu formatta olduğunu kontrol edin: Bearer YOUR_API_KEY. Anahtarınızı panelden doğrulayın.

json

{
  "error": "Validation Error",
  "message": "The email field must be a valid email address.",
  "status_code": 422
}

Çözüm: E-posta değerinin geçerli bir e-posta formatında olduğundan emin olun (örn. user@example.com). Girdinizi göndermeden önce temizleyin.

json

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Please slow down.",
  "status_code": 429,
  "retry_after": 15
}

Çözüm: Şu alandaki saniye kadar bekleyin: retry_after ve ardından tekrar deneyin. Bkz. İstek Limitleri →

✅ API anahtarı şununla başlıyor: ev_ ve doğru
✅ Authorization başlık formatı: Bearer YOUR_KEY (şu değil: Token veya Basic)
✅ Content-Type: application/json başlığı ayarlanmış
✅ İstek gövdesi geçerli JSON
✅ email alanı bir string; null veya eksik değil
✅ Kalan krediniz var (kontrol edin: Krediler →)