API-Fehlermeldungen
Bei der Verwendung unserer API können Fehler auftreten. Was sie bedeuten, erfahren Sie hier.
HTTPS-Fehler
Die API meldet das Auftreten eines Fehlers hauptsächlich durch die Rückgabe eines HTTP-Statuscodes.
-Codes im 2xx-Bereich zeigen Erfolg
Codes im Bereich 4xx weisen auf einen Fehler hin, der sich aus den bereitgestellten Informationen ergibt
Codes im Bereich 5xx weisen auf einen Fehler bei Billwerk+ oder bei von Billwerk+ genutzten Fremdsystemen hin.
200 - OK Alles funktioniert wie erwartet
400 - Bad Request Unzulässiger Vorgang auf eine Ressource.
401 - Unauthorized Keine gültige Authentifizierung vorhanden
403 - Forbidden Authentifizierung gegeben, aber nicht autorisiert, die Ressource zu bedienen.
404 - Not Found Die angeforderte Ressource oder die referenzierten Ressourcen konnten nicht gefunden werden.
405 - Method Not Allowed Die verwendete HTTP-Methode ist für die Ressource nicht zulässig.
422 - Unprocessable Entity Die Anfrage konnte nicht interpretiert werden, da häufig ein erforderlicher Parameter fehlt oder die Parameter falsch formatiert sind, z. B. schlecht formatiertes JSON.
500 - 504 - Server Errors Auf Seiten von Billwerk+ ist ein interner Fehler aufgetreten.
Fehler-Antwort
Alle nicht erfolgreichen 2xx-Antworten geben eine generische JSON-Fehlerantwort mit den folgenden Parametern zurück.