Fehler behandeln
Maschinenlesbare Fehler nach RFC 9457.
Fehler haben den Content-Type application/problem+json. Verzweige anhand von code und HTTP-Status. detail erklärt den Fehler; errors enthält gegebenenfalls Feldfehler mit Punktpfaden. request_id verbindet deine Anfrage mit dem Serverprotokoll.
{
"type": "https://developers.adlass.io/errors/insufficient_scope",
"title": "Insufficient scope",
"status": 403,
"code": "insufficient_scope",
"required_scope": "spaces:write",
"request_id": "req_…"
}| Status | Vorgehen |
|---|---|
| 400 | Parameter und Idempotency-Key prüfen |
| 401 | Schlüssel, Umgebung, Ablauf und Widerruf prüfen |
| 403 | Scope und Benutzerrechte prüfen |
| 404 | Ressource oder Route nicht verfügbar |
| 409 | Fachlichen Konflikt auflösen |
| 422 | Idempotency-Key nicht für eine andere Absicht wiederverwenden |
| 429 | Retry-After abwarten |
| 5xx | Mit derselben Idempotenz-ID begrenzt wiederholen |
Der type-Link führt zur Referenz des konkreten Fehlercodes. Provider-Interna werden nicht veröffentlicht. Gib bei Supportanfragen die request_id an, niemals den API-Schlüssel.