Rujukan
Ralat API dan kod ralat
Ralat menggunakan kod status HTTP dan sentiasa mempunyai badan JSON yang sama. param menamakan medan apabila satu medan adalah penyebabnya. Setiap jawapan mempunyai pengepala X-Request-Id: petiknya dalam tiket sokongan.
{
"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"
}
}Kod
| code | HTTP | Penyebab | Wang |
|---|---|---|---|
| invalid_json | 400 | Badan bukan objek JSON, atau Content-Type bukan application/json. | Betulkan badan. Tiada caj dikenakan. |
| invalid_request | 400 | Medan tiada atau jenis salah; param menamakannya. | Betulkan medan. Tiada caj dikenakan. |
| invalid_number | 400 | Tiada nombor dalam permintaan boleh dibaca sebagai E.164 (+ dan 7 hingga 15 digit). | Semak nombor. Tiada caj dikenakan. |
| unsupported_country | 400 / 404 | Tiada negara berharga sepadan dengan nombor, atau GET /v1/pricing/{country} mempunyai kod tidak dikenali. | Semak senarai negara. Tiada caj dikenakan. |
| text_too_long | 400 | Teks memerlukan lebih daripada 10 segmen. | Pendekkan teks. Tiada caj dikenakan. |
| too_many_recipients | 400 | Lebih daripada 10,000 penerima dalam satu permintaan. | Pisahkan senarai. Tiada caj dikenakan. |
| schedule_out_of_range | 400 | send_at bukan masa sah antara 2 minit dan 45 hari dari sekarang. | Pilih masa lain. Tiada caj dikenakan. |
| suppressed | 400 | Setiap nombor dalam permintaan ada dalam senarai jangan-hantar (Tetapan dalam konsol). | Tiada yang dihantar atau dicaj. |
| unauthorized | 401 | Header Authorization tiada, rosak, atau kunci telah dibatalkan. | Hantar kunci aktif. Tiada caj dikenakan. |
| top_up_required | 402 | Baki lebih rendah daripada kos permintaan; mesej menyatakan kedua-dua jumlah. | Isi semula dan hantar lagi. Tiada caj dikenakan. |
| not_found | 404 | Id tidak wujud dalam akaun ini, atau endpoint tidak wujud. | Semak id dan laluan. |
| idempotency_conflict | 409 | Idempotency-Key telah digunakan dengan badan permintaan berbeza dalam 24 jam lepas. | Gunakan kunci baru untuk permintaan baru. |
| not_cancelable | 409 | Hanya batch berjadual boleh dibatalkan; ini telah bermula atau selesai. | Tiada perubahan. |
| rate_limited | 429 | Kunci membuat lebih daripada 600 permintaan dalam 60 saat lepas. | Tunggu Retry-After saat. Tiada caj dikenakan. |
| server_error | 500 | Sesuatu gagal di pihak kami. | Cuba semula dengan Idempotency-Key yang sama. |
Mencuba semula
- Ralat 4xx selain 429 memerlukan perubahan pada permintaan; menghantar permintaan yang sama lagi akan memberikan ralat yang sama.
- Pada 429, tunggu bilangan saat dalam Retry-After.
- Pada 5xx atau masa tamat rangkaian, cuba semula dengan Idempotency-Key yang sama: jika permintaan pertama diterima, anda akan mendapat jawapannya kembali dan bukannya penghantaran kedua.