Tüm API hataları error alanlı JSON gövdesi döndürür. 4xx genellikle istek, hesap veya hız limiti düzeltmesi gerektirir; 5xx sunucu taraflı ya da geçicidir, ancak yeniden deneme güvenliği eyleme bağlıdır.
| Kod | Ad | Anlamı |
|---|---|---|
| 400 | Bad Request | Zorunlu değer eksik, bozuk, desteklenmeyen veya izin verilen aralık dışında olduğu için doğrulama başarısız oldu. Yeniden denemeden önce isteği düzeltin. |
| 403 | Forbidden | Anahtarın veya hesabın bu eyleme izni yoktur; örneğin hesap askıdayken. Değiştirmeden yeniden denemek yardımcı olmaz. |
| 404 | Not Found | İstenen API kaynağı bulunamadı veya bu anahtara açık değil. Yeniden denemeden önce tanımlayıcıyı ve hesap sahipliğini doğrulayın. |
| 409 | Conflict | İstek mevcut durumla çakışıyor; örneğin farklı mantıksal sipariş için add request_id yeniden kullanılmış. Uygun şekilde özgün isteği veya yeni benzersiz tanımlayıcıyı kullanın. |
| 413 | Content Too Large | İstek gövdesi çok büyük. Yeniden denemeden önce yükü azaltın veya desteklenen toplu istekleri bölün. |
| 429 | Too Many Requests | Hız veya eylem limiti isteği reddetti. Varsa X-RateLimit-DeniedBy'ı inceleyin ve X-RateLimit-Reset'teki göreli saniye kadar bekleyin. |
| 500 | Internal Server Error | Beklenmeyen sunucu tarafı hatası oluştu. Her yazmanın güvenle tekrarlanabileceğini varsaymayın; aşağıdaki eyleme özgü kılavuzu izleyin. |
| 502 | Bad Gateway | Sağlayıcı, yerine getirme isteğini reddetti. Yeniden denemeden önce hizmetin kullanılabilirliğini ve istek verilerini kontrol edin. |
| 503 | Service Unavailable | API veya gerekli işlem geçici olarak kullanılamıyor; uygun sağlayıcının mevcut olmaması (provider_not_found) da buna dahildir. Geri çekilmeyle sonra deneyin, varsa Retry-After değerine uyun ve desteklenen eylemlerde aynı idempotency tanımlayıcısını koruyun. |
{
"error": "Missing required parameter: service"
}Eylem, dahil edilmemiş bir parametre gerektiriyor. İstek gövdesine ekleyin ve yeniden deneyin.
{
"error": "Invalid API key"
}Yanlış anahtar, iptal edilmiş anahtar veya eksik anahtar. Değerin /dashboard/api'de gösterilenle eşleştiğini kontrol edin. Sıralama saldırılarını önlemek için hata, eksik ve geçersiz için aynıdır.
{
"error": "Insufficient balance"
}Hesap bakiyeniz, siparişin toplam ücretinin altında. /dashboard/wallet üzerinden yükleme yapın veya bir kupon uygulayın.
{
"error": "Service not found"
}Hizmet ID'si mevcut değil. Kataloğu action=services ile yenileyip güncel bir ID seçin; kullanımdan kaldırılan hizmetler ayrı bir 400 hatası döndürür.
{
"error": "Rate limit exceeded"
}Hız veya eylem limiti isteği reddetti. Varsa X-RateLimit-DeniedBy'ı inceleyin ve X-RateLimit-Reset'teki göreli saniye kadar bekleyin.
{
"error": "language must be one of en, es, pt, ru, tr, ar, hi, id, fr, zh",
"error_code": "INVALID_LANGUAGE"
}services ve catalog yalnızca en, es, pt, ru, tr, ar, hi, id, fr veya zh kodlarını kabul eder. Yeniden denemeden önce dil değerini düzeltin.
Yinelenen siparişi önlemek için action=add işlemini aynı request_id ve aynı mantıksal istekle yeniden deneyin; farklı bir sipariş için yeni ve benzersiz bir değer kullanın. Okuma işlemleri güvenle tekrarlanabilir. Sipariş uygun kaldığı sürece iptal tekrarları güvenlidir.