Sanggunian
Mga error at error code ng API
Ang mga error ay gumagamit ng HTTP status codes at palaging may parehong JSON body. Ang param ay nagpapangalan sa field kapag isang field ang sanhi. Bawat sagot ay may X-Request-Id header: isama ito sa isang support ticket.
{
"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"
}
}Mga Code
| code | HTTP | Sanhi | Pera |
|---|---|---|---|
| invalid_json | 400 | Ang body ay hindi JSON object, o ang Content-Type ay hindi application/json. | Ayusin ang body. Walang na-charge. |
| invalid_request | 400 | Kulang ang field o mali ang type nito; nakalista ang param. | Ayusin ang field. Walang na-charge. |
| invalid_number | 400 | Walang number sa request na mababasa bilang E.164 (+ at 7 hanggang 15 digits). | Tingnan ang mga number. Walang na-charge. |
| unsupported_country | 400 / 404 | Walang priced country na tumutugma sa mga number, o ang GET /v1/pricing/{country} ay may unknown code. | Tingnan ang listahan ng bansa. Walang na-charge. |
| text_too_long | 400 | Ang text ay nangangailangan ng higit sa 10 segments. | Paikliin ang text. Walang na-charge. |
| too_many_recipients | 400 | Higit sa 10,000 recipients sa isang request. | Hatiin ang listahan. Walang na-charge. |
| schedule_out_of_range | 400 | Ang send_at ay hindi valid na oras sa pagitan ng 2 minuto at 45 araw mula ngayon. | Pumili ng ibang oras. Walang na-charge. |
| suppressed | 400 | Lahat ng number sa request ay nasa do-not-send list mo (Settings sa console). | Walang na-send o na-charge. |
| unauthorized | 401 | Kulang ang Authorization header, may mali sa format, o na-revoke ang key. | Magpadala ng live key. Walang na-charge. |
| top_up_required | 402 | Mas mababa ang balance kaysa sa halaga ng request; nakalista ang parehong amount sa mensahe. | Mag-top up at mag-send ulit. Walang na-charge. |
| not_found | 404 | Ang id ay wala sa account na ito, o ang endpoint ay hindi umiiral. | Tingnan ang id at ang path. |
| idempotency_conflict | 409 | Ang Idempotency-Key ay ginamit sa ibang request body sa nakaraang 24 oras. | Gumamit ng bagong key para sa bagong request. |
| not_cancelable | 409 | Ang scheduled batch lang ang maaaring i-cancel; ito ay nagsimula na o natapos na. | Walang nagbago. |
| rate_limited | 429 | Ang key ay gumawa ng higit sa 600 requests sa nakaraang 60 segundo. | Maghintay ng Retry-After segundo. Walang na-charge. |
| server_error | 500 | May nagkaproblema sa aming side. | Subukan ulit gamit ang parehong Idempotency-Key. |
Sinusubukan muli
- Ang mga 4xx error maliban sa 429 ay nangangailangan ng pagbabago sa request; ang pagpapadala ng parehong request ay magbibigay ng parehong error.
- Sa 429, hintayin ang bilang ng segundo sa Retry-After.
- Sa 5xx o network timeout, subukan ulit gamit ang parehong Idempotency-Key: kung ang unang request ay tinanggap, makukuha mo ang unang sagot imbes na pangalawang pagpapadala.