Fehler-Codes
Die CheckYout API verwendet standardmässige HTTP-Statuscodes und gibt strukturierte JSON-Fehlermeldungen zurück.
Fehlerformat
Alle Fehlerantworten folgen diesem Format:
{
"error": "Kurze Fehlerbeschreibung",
"details": "Optionale zusätzliche Informationen"
}| Feld | Typ | Beschreibung |
|---|---|---|
error | string | Kurze, maschinenlesbare Fehlerbeschreibung. Immer vorhanden. |
details | string | Optionale zusätzliche Informationen zur Fehlerursache. |
HTTP-Statuscodes
| Code | Bedeutung | Typische Ursache | Beispiel |
|---|---|---|---|
200 | OK | Anfrage erfolgreich verarbeitet | {"success":true,"message_sid":"SM..."} |
400 | Bad Request | Fehlende Pflichtfelder oder ungültiges Format | {"error":"Missing required fields: device_id, phone"} |
400 | Bad Request | Ungültiges Telefonnummernformat | {"error":"Phone must be in E.164 format (starting with +)"} |
401 | Unauthorized | Fehlender oder ungültiger API-Key | {"error":"Invalid or missing API key"} |
404 | Not Found | Gerät existiert nicht oder gehört nicht zum Account | {"error":"Device not found or does not belong to your account"} |
429 | Too Many Requests | Rate-Limit überschritten | Geplant für v1.1 |
500 | Internal Server Error | WhatsApp-Versand fehlgeschlagen | {"error":"Failed to send WhatsApp","details":"..."} |
Fehlerbehandlung
- 4xx-Fehler: Prüfen Sie Ihre Anfrage — API-Key, Pflichtfelder, Telefonnummernformat, Device-Zuordnung.
- 5xx-Fehler: Serverseitiges Problem. Versuchen Sie die Anfrage nach kurzer Wartezeit erneut.
- Werten Sie immer den HTTP-Statuscode und das
error-Feld aus.
Retry-Strategie
Wir empfehlen bei 5xx-Fehlern einen Retry mit exponentiellem Backoff (z.B. 1s, 5s, 30s) und maximal 3 Versuchen.
Nächster Schritt: Changelog