Über Fehler wird der Benutzer durch einen HTTP-Statuscode informiert.
HTTP-Code | Bedeutung von |
200 OK | Die Operation wurde erfolgreich durchgeführt. |
201 Erstellt | Der Datensatz wurde erfolgreich erstellt. Der |
304 Nicht geändert | Der Datensatz wurde nicht geändert (in Kombination mit dem |
400 Schlechte Anfrage | Schlechte Anfrage. Tritt normalerweise auf, wenn eine PUT-Operation fehlgeschlagen ist (z. B. wenn Sie ein Objekt referenzieren, das nicht existiert). |
401 Nicht autorisiert | Der Benutzer muss angemeldet sein, um den Vorgang ausführen zu können. |
402 Zahlung erforderlich | Das Zielsystem hat die REST-API nicht zum Schreiben aktiviert. Bei Lesevorgängen wird ein 404 zurückgegeben. |
403 Verboten | Der Benutzer ist für diesen Vorgang nicht berechtigt. Dieser Fehler wird auch dann angezeigt, wenn der Vorgang durch die Lizenz nicht erlaubt ist. |
404 Nicht gefunden | Datensatz nicht gefunden. Dies kann ein Datensatz oder ein bestimmter Datensatz sein (z. B. weil er gelöscht wurde). |
406 Nicht akzeptabel | Das Zielformat wird über eine bestimmte Ressource nicht unterstützt (z. B. Verzeichnisexport als ISDOC). |
500 Interner Serverfehler | Bei der Verarbeitung der Anfrage ist ein interner Serverfehler aufgetreten. Dies sollte normalerweise nicht auftreten und ist immer ein Fehler im ABRA-Flexi-Code. Bitte informieren Sie uns. |
Die Antwort, sofern es sich nicht um einen 500-Fehler handelt, enthält normalerweise eine maschinenlesbare Beschreibung (XML, JSON). Das Format ist identisch mit dem der Validierungsmeldungen.
Beispielhafte Fehlerreaktion:
<?xml version="1.0"?>
<winstrom version="1.0">
<success>false</success>
<result>
<id>105</id>
<error>Beim Speichern ist ein unbekannter Fehler aufgetreten.</error>
</result>
</winstrom>