Fehler
Fehlercodes der REST-API von vynst (inwendo ERP) verstehen und behandeln.
Fehler kommen mit einem passenden HTTP-Status und zwei zusätzlichen Headern:
| Header | Inhalt |
|---|---|
X-IW-ERROR-CODE |
interner Fehlercode, zum Beispiel 1305 |
X-IW-ERROR-JSON |
Details als JSON, etwa die Felder eines ungültigen Formulars |
Der HTTP-Status sagt, was grundsätzlich schiefging. Der interne Code sagt genauer, warum.
| Status | Bedeutung |
|---|---|
400 |
Anfrage ungültig, zum Beispiel ein Pflichtfeld fehlt |
401 |
nicht angemeldet oder Token abgelaufen |
403 |
angemeldet, aber das nötige Recht fehlt |
404 |
Eintrag nicht gefunden |
409 |
Eintrag wurde zwischenzeitlich geändert |
500 |
Fehler auf dem Server |
Häufige interne Codes:
| Code | Bedeutung |
|---|---|
1100 |
Wartungsmodus |
1300, 1301 |
Formular ungültig, Details in X-IW-ERROR-JSON |
1302 |
E-Mail-Adresse ungültig |
1305 |
Eintrag existiert bereits |
1400 |
Passwort zu schwach |
Ist eine Funktion in den Einstellungen der Instanz ausgeschaltet, antworten ihre Endpunkte mit 400 und dem Text feature disabled: <id>.