Hata Kodları

API hata yanıtları ve çözümleri

Onysoft API, standart HTTP durum kodları ve detaylı hata mesajları döndürür.

HTTP Durum Kodları

Kod	Anlam	Açıklama
`200`	OK	İstek başarıyla tamamlandı
`400`	Bad Request	Geçersiz istek formatı veya eksik parametre
`401`	Unauthorized	Geçersiz veya eksik API anahtarı
`402`	Payment Required	Yetersiz bakiye
`429`	Too Many Requests	Rate limit aşıldı
`500`	Internal Server Error	Sunucu hatası

Hata Yanıt Formatı

                JSON
            

{
  "success": false,
  "error": {
    "code": "insufficient_balance",
    "message": "Yetersiz bakiye. Lütfen bakiye yükleyin."
  }
}
            

Yaygın Hatalar ve Çözümleri

invalid_api_key

API anahtarınız geçersiz veya deaktif edilmiş. Dashboard'dan yeni bir anahtar oluşturun.

insufficient_balance

Bakiyeniz bu işlem için yetersiz. Dashboard'dan bakiye yükleyin.

model_not_found

Belirtilen model bulunamadı. Model ID'sinin doğru olduğundan emin olun.

rate_limit_exceeded

Dakikalık istek limitini aştınız. Biraz bekleyip tekrar deneyin.