Referenz
API-Fehler und Fehlercodes
Fehler verwenden HTTP-Statuscodes und haben immer den gleichen JSON-Body. param benennt das Feld, wenn ein Feld die Ursache ist. Jede Antwort hat einen X-Request-Id-Header: zitieren Sie ihn in einem 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"
}
}Codes
| code | HTTP | Ursache | Geld |
|---|---|---|---|
| invalid_json | 400 | Der Body ist kein JSON-Objekt, oder Content-Type ist nicht application/json. | Korrigieren Sie den Body. Es wurde nichts berechnet. |
| invalid_request | 400 | Ein Feld fehlt oder hat den falschen Typ; param benennt es. | Korrigieren Sie das Feld. Es wurde nichts berechnet. |
| invalid_number | 400 | Keine Nummer in der Anfrage konnte als E.164 (+ und 7 bis 15 Ziffern) gelesen werden. | Überprüfen Sie die Nummern. Es wurde nichts berechnet. |
| unsupported_country | 400 / 404 | Kein bewertetes Land passt zu den Nummern, oder GET /v1/pricing/{country} hat einen unbekannten Code. | Überprüfen Sie die Länderliste. Es wurde nichts berechnet. |
| text_too_long | 400 | Der Text benötigt mehr als 10 Segmente. | Kürzen Sie den Text. Es wurde nichts berechnet. |
| too_many_recipients | 400 | Mehr als 10.000 Empfänger in einer Anfrage. | Teilen Sie die Liste auf. Es wurde nichts berechnet. |
| schedule_out_of_range | 400 | send_at ist keine gültige Zeit zwischen 2 Minuten und 45 Tagen ab jetzt. | Wählen Sie eine andere Zeit. Es wurde nichts berechnet. |
| suppressed | 400 | Jede Nummer in der Anfrage steht auf Ihrer Do-Not-Send-Liste (Einstellungen in der Konsole). | Es wurde nichts gesendet oder berechnet. |
| unauthorized | 401 | Der Authorization-Header fehlt, ist fehlerhaft oder der Schlüssel wurde widerrufen. | Senden Sie einen Live-Schlüssel. Es wurde nichts berechnet. |
| top_up_required | 402 | Das Guthaben ist niedriger als die Kosten der Anfrage; die Nachricht nennt beide Beträge. | Laden Sie auf und senden Sie erneut. Es wurde nichts berechnet. |
| not_found | 404 | Die ID existiert nicht in diesem Konto, oder der Endpunkt existiert nicht. | Überprüfen Sie die ID und den Pfad. |
| idempotency_conflict | 409 | Die Idempotency-Key wurde in den letzten 24 Stunden mit einem anderen Request-Body verwendet. | Verwenden Sie einen neuen Schlüssel für eine neue Anfrage. |
| not_cancelable | 409 | Nur ein geplanter Batch kann storniert werden; dieser hat bereits begonnen oder ist abgeschlossen. | Nichts wurde geändert. |
| rate_limited | 429 | Der Schlüssel hat in den letzten 60 Sekunden mehr als 600 Anfragen gemacht. | Warten Sie Retry-After Sekunden. Es wurde nichts berechnet. |
| server_error | 500 | Etwas ist auf unserer Seite fehlgeschlagen. | Wiederholen Sie die Anfrage mit demselben Idempotency-Key. |
Wiederholen
- 4xx-Fehler außer 429 erfordern eine Änderung der Anfrage; das erneute Senden derselben Anfrage führt zum gleichen Fehler.
- Bei 429 warten Sie die in Retry-After angegebene Anzahl Sekunden.
- Bei 5xx oder einem Netzwerk-Timeout wiederholen Sie die Anfrage mit demselben Idempotency-Key: Wenn die erste Anfrage akzeptiert wurde, erhalten Sie deren Antwort zurück anstelle eines erneuten Versands.