Skip to content

Error Handling

This content is not available in your language yet.

Das standardisierte Schema der LIVOI-API wurde für eine klare, konsistente und effiziente Fehlerbehandlung in Integrationen entwickelt. Es ermöglicht eine präzise Fehlererkennung, eine gezielte Weiterverarbeitung und eine stabile Automatisierung von Fehlerfällen. Das Ergebnis sind geringere Wartungskosten, eine schnellere Fehlersuche und eine höhere Zuverlässigkeit in der Systemkommunikation.

Die Fehlerrückgabe umfasst:

  • status_code - numerischer HTTP-Statuscode der Antwort
  • status_message - textuelle Beschreibung des Statuscodes
  • errors - Liste mit detaillierten Informationen zu Ursache und Typ des Fehlers
{
"status_code": 403,
"status_message": "Forbidden",
"errors": [
{
"info": "Access denied. You do not have permission to perform this action.",
"type": "Exception",
"cause": {
"details": "Access denied. You do not have permission to perform this action."
}
}
]
}

Alle API-Fehler folgen einem standardisierten JSON-Format für konsistente Fehlerbehandlung:

CodeStatusBeschreibung
200OKStandardantwort für erfolgreiche HTTP-Anfragen. Die Ressource wurde erfolgreich abgerufen oder verarbeitet.
201CreatedDie Anfrage war erfolgreich und eine neue Ressource wurde erstellt. Wird typischerweise bei POST-Anfragen verwendet.
204No ContentDie Anfrage war erfolgreich, aber es gibt keinen Inhalt zurückzugeben. Häufig bei DELETE-Operationen.