Referensi
Kesalahan API dan kode kesalahan
Kesalahan menggunakan kode status HTTP dan selalu memiliki body JSON yang sama. param menamai bidang ketika satu bidang adalah penyebabnya. Setiap jawaban memiliki header X-Request-Id: kutip dalam tiket dukungan.
{
"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"
}
}Kode
| code | HTTP | Penyebab | Uang |
|---|---|---|---|
| invalid_json | 400 | Body bukan objek JSON, atau Content-Type bukan application/json. | Perbaiki body. Tidak ada yang dibebankan. |
| invalid_request | 400 | Sebuah field hilang atau memiliki tipe yang salah; param menunjukkannya. | Perbaiki field. Tidak ada yang dibebankan. |
| invalid_number | 400 | Tidak ada nomor dalam permintaan yang dapat dibaca sebagai E.164 (+ dan 7 hingga 15 digit). | Periksa nomor-nomor tersebut. Tidak ada yang dibebankan. |
| unsupported_country | 400 / 404 | Tidak ada negara yang sesuai dengan harga untuk nomor-nomor tersebut, atau GET /v1/pricing/{country} memiliki kode yang tidak dikenal. | Periksa daftar negara. Tidak ada yang dibebankan. |
| text_too_long | 400 | Teks membutuhkan lebih dari 10 segmen. | Persingkat teks. Tidak ada yang dibebankan. |
| too_many_recipients | 400 | Lebih dari 10.000 penerima dalam satu permintaan. | Bagi daftar tersebut. Tidak ada yang dibebankan. |
| schedule_out_of_range | 400 | send_at bukan waktu yang valid antara 2 menit hingga 45 hari dari sekarang. | Pilih waktu lain. Tidak ada yang dibebankan. |
| suppressed | 400 | Setiap nomor dalam permintaan ada di daftar do-not-send Anda (Pengaturan di konsol). | Tidak ada yang dikirim atau dibebankan. |
| unauthorized | 401 | Header Authorization hilang, tidak sesuai format, atau kunci telah dicabut. | Kirim kunci live. Tidak ada yang dibebankan. |
| top_up_required | 402 | Saldo lebih rendah dari biaya permintaan; pesan menyebutkan kedua jumlah tersebut. | Isi ulang dan kirim lagi. Tidak ada yang dibebankan. |
| not_found | 404 | ID tidak ada di akun ini, atau endpoint tidak ada. | Periksa ID dan jalur tersebut. |
| idempotency_conflict | 409 | Idempotency-Key digunakan dengan body permintaan yang berbeda dalam 24 jam terakhir. | Gunakan kunci baru untuk permintaan baru. |
| not_cancelable | 409 | Hanya batch yang terjadwal yang dapat dibatalkan; batch ini sudah dimulai atau selesai. | Tidak ada yang berubah. |
| rate_limited | 429 | Kunci melakukan lebih dari 600 permintaan dalam 60 detik terakhir. | Tunggu Retry-After detik. Tidak ada yang dibebankan. |
| server_error | 500 | Terjadi kesalahan di pihak kami. | Coba lagi dengan Idempotency-Key yang sama. |
Mencoba ulang
- Error 4xx selain 429 memerlukan perubahan pada request; mengirim request yang sama akan menghasilkan error yang sama.
- Pada error 429, tunggu jumlah detik yang ditunjukkan di Retry-After.
- Pada error 5xx atau timeout jaringan, coba lagi dengan Idempotency-Key yang sama: jika request pertama diterima, Anda akan mendapatkan jawaban yang sama alih-alih pengiriman kedua.