Referans
API hataları ve hata kodları
Hatalar HTTP durum kodlarını kullanır ve her zaman aynı JSON gövdesine sahiptir. param, bir alanın neden olduğu durumda alanı adlandırır. Her yanıt bir X-Request-Id başlığına sahiptir: bir destek bileti alıntılayın.
{
"error": {
"code": "text_too_long",
"message": "The text is longer than 10 segments (1,530 GSM-7 or 670 UCS-2 characters).",
"param": "text",
"doc_url": "https://bulksmsapi.cc/en/docs/errors#text_too_long"
}
}Kodlar
| code | HTTP | Neden | Para |
|---|---|---|---|
| invalid_json | 400 | Gövde bir JSON nesnesi değil veya Content-Type application/json değil. | Gövdeyi düzeltin. Hiçbir ücret alınmadı. |
| invalid_request | 400 | Bir alan eksik veya yanlış türde; parametre adı belirtilmiştir. | Alanı düzeltin. Hiçbir ücret alınmadı. |
| invalid_number | 400 | İstekteki hiçbir numara E.164 (+ ve 7-15 basamak) olarak okunamadı. | Numaraları kontrol edin. Hiçbir ücret alınmadı. |
| unsupported_country | 400 / 404 | Numaralarla eşleşen fiyatlandırılmış ülke yok veya GET /v1/pricing/{country} bilinmeyen bir kod içeriyor. | Ülke listesini kontrol edin. Hiçbir ücret alınmadı. |
| text_too_long | 400 | Metin 10'dan fazla segment gerektiriyor. | Metni kısaltın. Hiçbir ücret alınmadı. |
| too_many_recipients | 400 | Bir istekte 10.000'den fazla alıcı var. | Listeyi bölün. Hiçbir ücret alınmadı. |
| schedule_out_of_range | 400 | send_at, şu andan itibaren 2 dakika ile 45 gün arasında geçerli bir zaman değil. | Başka bir zaman seçin. Hiçbir ücret alınmadı. |
| suppressed | 400 | İstekteki her numara gönderme yapılmayacaklar listesinde (Konsoldaki Ayarlar). | Hiçbir şey gönderilmedi veya ücret alınmadı. |
| unauthorized | 401 | Authorization başlığı eksik, hatalı veya anahtar iptal edilmiş. | Geçerli bir anahtar gönderin. Hiçbir ücret alınmadı. |
| top_up_required | 402 | Bakiye, isteğin maliyetinden düşük; mesaj her iki tutarı da gösterir. | Bakiye yükleyip tekrar gönderin. Hiçbir ücret alınmadı. |
| not_found | 404 | Bu hesapta id mevcut değil veya endpoint bulunmuyor. | id ve yolu kontrol edin. |
| idempotency_conflict | 409 | Idempotency-Key son 24 saatte farklı bir istek gövdesiyle kullanıldı. | Yeni bir istek için yeni bir anahtar kullanın. |
| not_cancelable | 409 | Yalnızca planlanmış bir batch iptal edilebilir; bu zaten başladı veya bitti. | Hiçbir şey değişmedi. |
| rate_limited | 429 | Anahtar son 60 saniyede 600'den fazla istek yaptı. | Retry-After saniye bekleyin. Hiçbir ücret alınmadı. |
| server_error | 500 | Bizim tarafımızda bir hata oluştu. | Aynı Idempotency-Key ile yeniden deneyin. |
Yeniden deneme
- 429 dışındaki 4xx hataları, istekte bir değişiklik gerektirir; aynı isteği tekrar göndermek aynı hatayı verir.
- 429 durumunda, Retry-After'da belirtilen saniye kadar bekleyin.
- 5xx veya ağ zaman aşımı durumunda, aynı Idempotency-Key ile yeniden deneyin: ilk istek kabul edilmişse, ikinci bir gönderme yerine ilk cevabı alırsınız.