Fouten
Een code voor de machine, een zin voor de mens.
Vertak op de code, nooit op de zin. De zin is vertaald en kan in elke release anders luiden; de code hoort bij het contract en verandert alleen met de versie in het pad.
| Code | Status | Wanneer die optreedt |
|---|---|---|
| UNAUTHENTICATED | 401 | Geen sleutel, een onleesbare, een ingetrokken of een verlopen sleutel. Alle vier antwoorden gelijk. |
| ANFRAGE | 400 | Het verzoek was niet leesbaar: een ontbrekend verplicht veld, een waarde in de verkeerde vorm. |
| PLAN_ERFORDERLICH | 403 | Het abonnement van dit bedrijf omvat de interface niet. Alleen het bedrijf kan dat wijzigen. |
| KEINE_BERECHTIGUNG | 403 | De sleutel draagt niet het bereik dat dit adres vereist. |
| NICHT_GEFUNDEN | 404 | Dit record bestaat niet — of het hoort bij een ander bedrijf. Beide antwoorden gelijk, met opzet. |
| IDEMPOTENZ_KONFLIKT | 409 | Dezelfde idempotentiesleutel is al gebruikt voor een andere inhoud of een ander adres. |
| FALSCHER_ZUSTAND | 409 | Het verzoek was in orde; de toestand van het record staat het niet toe. |
| ABGELEHNT | 409 | Een vakinhoudelijke regel wees de wijziging af. De zin ernaast zegt welke. |
| ZU_VIELE_ANFRAGEN | 429 | Het budget van deze sleutel is op. Retry-After noemt de wachttijd in seconden. |
De vorm van elke weigering.
Twee velden, altijd dezelfde. Geen stacktrace, geen query, geen bestandspad: wat terugkomt noemt de regel en verder niets over de binnenkant.
{"fehler": "…", "code": "KEINE_BERECHTIGUNG"}Het nummer dat u kunt aanhalen.
Elk antwoord draagt deze header, ook elke weigering. Stuurt u uw eigen waarde, dan staat die in onze registratie; stuurt u er geen, dan maken wij er een. Bij support vervangt hij een tijdstip.
X-Correlation-Id: 6f1c2a8e-4b3d-4a21-9d77-0c5e1f9b2a44