Riferimento
Errori API e codici di errore
Gli errori utilizzano codici di stato HTTP e hanno sempre lo stesso corpo JSON. param nomina il campo quando un campo è la causa. Ogni risposta ha un'intestazione X-Request-Id: citatela in un ticket di supporto.
{
"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"
}
}Codici
| code | HTTP | Causa | Denaro |
|---|---|---|---|
| invalid_json | 400 | Il corpo non è un oggetto JSON o Content-Type non è application/json. | Correggi il corpo. Nessun addebito effettuato. |
| invalid_request | 400 | Manca un campo o ha il tipo sbagliato; il parametro lo indica. | Correggi il campo. Nessun addebito effettuato. |
| invalid_number | 400 | Nessun numero nella richiesta può essere letto come E.164 (+ e da 7 a 15 cifre). | Controlla i numeri. Nessun addebito effettuato. |
| unsupported_country | 400 / 404 | Nessun paese con prezzo corrisponde ai numeri, o GET /v1/pricing/{country} ha un codice sconosciuto. | Controlla la lista dei paesi. Nessun addebito effettuato. |
| text_too_long | 400 | Il testo richiede più di 10 segmenti. | Accorcia il testo. Nessun addebito effettuato. |
| too_many_recipients | 400 | Più di 10.000 destinatari in una richiesta. | Dividi la lista. Nessun addebito effettuato. |
| schedule_out_of_range | 400 | send_at non è un orario valido tra 2 minuti e 45 giorni da ora. | Scegli un altro orario. Nessun addebito effettuato. |
| suppressed | 400 | Ogni numero nella richiesta è nella tua lista di non invio (Impostazioni nella console). | Niente è stato inviato o addebitato. |
| unauthorized | 401 | L'header Authorization manca, è malformato o la chiave è stata revocata. | Invia una chiave valida. Nessun addebito effettuato. |
| top_up_required | 402 | Il saldo è inferiore al costo della richiesta; il messaggio indica entrambi gli importi. | Ricarica e invia di nuovo. Nessun addebito effettuato. |
| not_found | 404 | L'id non esiste in questo account o l'endpoint non esiste. | Controlla l'id e il percorso. |
| idempotency_conflict | 409 | L'Idempotency-Key è stata usata con un corpo della richiesta diverso nelle ultime 24 ore. | Usa una nuova chiave per una nuova richiesta. |
| not_cancelable | 409 | Solo un batch programmato può essere annullato; questo è iniziato o terminato. | Niente è cambiato. |
| rate_limited | 429 | La chiave ha effettuato più di 600 richieste negli ultimi 60 secondi. | Attendi i secondi indicati in Retry-After. Nessun addebito effettuato. |
| server_error | 500 | Qualcosa è fallito dal nostro lato. | Riprova con lo stesso Idempotency-Key. |
Riprova
- Gli errori 4xx diversi da 429 richiedono una modifica alla richiesta; inviare nuovamente la stessa richiesta restituirà lo stesso errore.
- Con errore 429, attendi il numero di secondi indicato in Retry-After.
- Con errore 5xx o timeout di rete, riprova con lo stesso Idempotency-Key: se la prima richiesta era stata accettata, riceverai nuovamente la sua risposta invece di un secondo invio.