Aller au contenu

API ecentic : erreurs.

Chaque échec sur l’API ecentic est un document de problème typé, pas une page HTML. Le code fait foi : il est stable, lisible par machine et peut être utilisé en toute sécurité dans une logique de branchement.

RFC 9457 · Codes stables · Indications de résolution

01

Structure d’un problème

Un seul type MIME, un seul schéma, sur chaque réponse 4xx et 5xx renvoyée par l’API.

application/problem+json

Les réponses utilisent Content-Type: application/problem+json — délibérément pas application/json, car le type MIME permet à un client générique de comprendre que le corps décrit un échec plutôt que la ressource demandée.

Exemple de réponse

Lire la réponse

type
L’URI qui nomme le problème, référencée dans cette documentation.
code
L’identifiant stable sur lequel votre client peut s’appuyer pour effectuer un branchement logique.
title
Un court résumé lisible par un humain.
status
Le statut HTTP, répété dans le corps de la réponse.
detail
Ce qui s’est mal passé pour cette requête précise.
resolution
L’étape suivante pour résoudre le problème.
documentation
La page de référence de la réponse.
instance
Le chemin de requête qui l’a produite, lorsqu’il est connu.
02

Catalogue des erreurs

Les codes sont figés une fois publiés. Les titres et indications peuvent être reformulés ; les codes ne le peuvent pas.

12Codes d’erreur publiés

Ouvrez un code pour consulter sa résolution. Chaque code dispose d’un lien permanent.

Lien permanent vers not-found

Comment résoudre

Check the path against the OpenAPI document at /openapi.json or the API catalog at /.well-known/api-catalog.

Lien permanent vers method-not-allowed

Lien permanent vers unauthenticated

Lien permanent vers unauthorized

Lien permanent vers payment-required

Lien permanent vers subscription-required

Lien permanent vers invalid-request

Lien permanent vers validation-failed

Lien permanent vers conflict

Lien permanent vers rate-limited

Lien permanent vers upstream-timeout

Lien permanent vers internal-error