Ana içeriğe geç

Hata Kodları

KolayBi API'de karşılaşabileceğiniz hata kodları ve çözümlerini bu bölümde bulabilirsiniz.

HTTP Hata Kodları​

400 - Bad Request​

Açıklama: İstek parametreleri hatalı veya eksik

Olası Nedenler:

  • Zorunlu parametreler eksik
  • Parametre formatı hatalı
  • Geçersiz değerler

Örnek:

{
  "success": false,
  "message": {
    "commercial_doc_type": ["Ticari Belge Türü alanı gereklidir."]
  }
}

401 - Unauthorized​

Açıklama: Kimlik doğrulama başarısız

Olası Nedenler:

  • Token geçersiz veya süresi dolmuş
  • Token formatı hatalı
  • API anahtarı geçersiz

Örnek:

{
  "success": false,
  "message": "AUTH.UNAUTHENTICATED"
}

Çözüm: Yeni access token alın

403 - Forbidden​

Açıklama: Bu işlem için yetkiniz yok

Olası Nedenler:

  • API anahtarı bu işleme yetkili değil
  • Channel bilgisi yanlış
  • IP kısıtlaması

Örnek:

{
  "success": false,
  "message": "AUTH.FORBIDDEN"
}

404 - Not Found​

Açıklama: İstenen kaynak bulunamadı

Olası Nedenler:

  • Geçersiz endpoint
  • Kaynak ID'si yanlış
  • Kaynak silinmiş

Örnek:

{
  "success": false,
  "message": "MODEL.NOT_FOUND"
}

429 - Too Many Requests​

Açıklama: Rate limit aşıldı

Olası Nedenler:

  • Çok fazla istek gönderildi
  • Rate limit aşıldı

Örnek:

{
  "success": false,
  "message": "RATE_LIMIT.EXCEEDED"
}

Çözüm: retry_after süre kadar bekleyin

500 - Internal Server Error​

Açıklama: Sunucu hatası

Olası Nedenler:

  • Sistem hatası
  • Veritabanı hatası
  • Beklenmeyen hata

Örnek:

{
  "success": false,
  "message": "SERVER_ERROR"
}