Erreurs
Un code pour la machine, une phrase pour l'humain.
Branchez sur le code, jamais sur la phrase. La phrase est traduite et peut être reformulée; le code fait partie du contrat et ne change qu'avec la version du chemin.
| Code | Statut | Quand il survient |
|---|---|---|
| UNAUTHENTICATED | 401 | Aucune clé, illisible, révoquée ou expirée. Les quatre répondent pareil. |
| ANFRAGE | 400 | La requête était illisible: champ obligatoire manquant, valeur mal formée. |
| PLAN_ERFORDERLICH | 403 | L'abonnement de cette société n'inclut pas l'interface. Seule l'entreprise peut y remédier. |
| KEINE_BERECHTIGUNG | 403 | La clé ne porte pas la portée exigée par cette adresse. |
| NICHT_GEFUNDEN | 404 | Cet enregistrement n'existe pas — ou appartient à une autre société. Réponse identique, à dessein. |
| IDEMPOTENZ_KONFLIKT | 409 | La même clé d'idempotence a déjà servi pour un autre contenu ou une autre adresse. |
| FALSCHER_ZUSTAND | 409 | La requête était correcte; l'état de l'enregistrement ne l'autorise pas. |
| ABGELEHNT | 409 | Une règle métier a refusé la modification. La phrase à côté indique laquelle. |
| ZU_VIELE_ANFRAGEN | 429 | Le budget de cette clé est épuisé. Retry-After indique l'attente en secondes. |
La forme de tout refus.
Deux champs, toujours les mêmes. Aucune trace d'exécution, aucune requête, aucun chemin de fichier: la réponse nomme la règle et rien d'autre.
{"fehler": "…", "code": "KEINE_BERECHTIGUNG"}Le numéro que vous pouvez citer.
Chaque réponse porte cet en-tête, refus compris. Envoyez votre valeur et elle figure dans nos journaux; sinon nous en créons une. En support, elle remplace l'heure approximative.
X-Correlation-Id: 6f1c2a8e-4b3d-4a21-9d77-0c5e1f9b2a44