Format d’erreur et codes d’erreur

Les intégrations doivent pouvoir comprendre et corriger rapidement les erreurs.

Format d’erreur

{
  "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."
    ]
  }
}

Codes d’erreur

Code	Description
`invalid_request`	La requête est syntaxiquement invalide.
`validation_failed`	Des champs obligatoires sont manquants ou certaines valeurs sont invalides.
`unauthorized`	L’authentification est manquante ou invalide.
`forbidden`	L’intégration n’est pas autorisée à effectuer cette action.
`not_found`	La ressource demandée est introuvable.
`conflict`	La requête entre en conflit avec l’état actuel.
`idempotency_conflict`	La clé d’idempotence a déjà été utilisée avec un contenu différent.
`rate_limited`	La limite d’utilisation a été dépassée.
`unsupported_service_type`	Le type de service indiqué n’est pas activé.
`internal_error`	Une erreur interne est survenue.

Codes de statut

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