Fouten

Responsformaat

Alle fouten retourneren een JSON-body:

{
  "error": {
    "code": "validation_failed",
    "message": "The given data was invalid.",
    "details": {
      "email": ["The email has already been taken."]
    }
  },
  "request_id": "req_01HXXXXXX"
}

Vermeld altijd de request_id wanneer u contact opneemt met ondersteuning over een fout.

HTTP-statuscodes

Status	Betekenis
200 OK	Succes
201 Created	Resource aangemaakt
400 Bad Request	Ongeldig verzoek
401 Unauthorized	Ontbrekend of ongeldig token
403 Forbidden	Geldig token maar onvoldoende rechten
404 Not Found	Resource niet gevonden
409 Conflict	Conflict (bijv. e-mailadres al in gebruik)
422 Unprocessable Entity	Validatie mislukt
429 Too Many Requests	Snelheidslimiet overschreden
500 Internal Server Error	Serverfout

Foutcodes

Code	Beschrijving
validation_failed	Verzoekbody heeft validatie niet doorstaan
unauthorized	Token ontbreekt of is verlopen
forbidden	Token mist de vereiste scope
not_found	Resource bestaat niet
conflict	Unieke beperking geschonden
rate_limited	Te veel verzoeken
internal_error	Onverwachte serverfout