Fehlerbehandlung
Wie die API Fehler kommuniziert und wie Sie damit umgehen.
HTTP-Statuscodes
| Code | Beschreibung |
|---|---|
| 200 | Anfrage erfolgreich |
| 201 | Ressource erfolgreich erstellt |
| 204 | Erfolgreich, keine Rückgabe (z.B. bei DELETE) |
| 400 | Ungültige Anfrage |
| 401 | Nicht authentifiziert |
| 403 | Keine Berechtigung (fehlender Bereich, Funktion nicht im Paket oder Tariflimit erreicht: "code": "plan_limit_reached") |
| 404 | Ressource nicht gefunden (auch, wenn ein Suchfilter wie event_key, category_key, customer_number oder invoice_number auf nichts verweist) |
| 405 | HTTP-Methode nicht erlaubt |
| 409 | Konflikt mit dem aktuellen Zustand (z. B. der Datensatz ist bereits abgerechnet) |
| 422 | Validierungsfehler |
| 429 | Anfragelimit überschritten |
| 500 | Interner Serverfehler |
Fehlerformat
// Validierungsfehler (422)
{
"error": "Validation failed",
"errors": {
"email": ["The email field is required."],
"name": ["The name must be at least 2 characters."]
}
}
// Ungültige Anfrage (400, 401, 403, 404, 429, 500)
{
"error": "Resource not found"
}