Fehlerformat und Fehlercodes

Integrationen sollen Fehler schnell verstehen und gezielt beheben können.

Fehlerformat

{
  "type": "https://docs.ordinavo.de/errors/validation_failed",
  "title": "Validation failed",
  "status": 400,
  "code": "validation_failed",
  "detail": "One or more fields are invalid.",
  "traceId": "00-85f1ac0ed64147f499c20e04af2a1c19",
  "errors": {
    "location.postalCode": [
      "Postal code is required."
    ],
    "preferredTimeWindows[0].from": [
      "Start time must be before end time."
    ]
  }
}

Fehlercodes

Code	Beschreibung
`invalid_request`	Die Anfrage ist syntaktisch ungültig.
`validation_failed`	Pflichtfelder fehlen oder Werte sind ungültig.
`unauthorized`	Authentifizierung fehlt oder ist ungültig.
`forbidden`	Die Integration hat keine Berechtigung für diese Aktion.
`not_found`	Die angeforderte Ressource wurde nicht gefunden.
`conflict`	Die Anfrage kollidiert mit dem aktuellen Status.
`idempotency_conflict`	Der Idempotency-Key wurde bereits mit anderem Inhalt verwendet.
`rate_limited`	Das Limit wurde überschritten.
`unsupported_service_type`	Die angegebene Serviceart ist nicht freigegeben.
`internal_error`	Ein interner Fehler ist aufgetreten.

Statuscodes

200 OK 201 Created 202 Accepted 400 Bad Request 401 Unauthorized 403 Forbidden 404 Not Found 409 Conflict 422 Unprocessable Entity 429 Too Many Requests 500 Internal Server Error