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
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.
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.
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.
Comment résoudre
Check the path against the OpenAPI document at /openapi.json or the API catalog at /.well-known/api-catalog.
Comment résoudre
Re-read the operation in /openapi.json; the `Allow` header lists the methods this path accepts.
Comment résoudre
Send `Authorization: Bearer ecentic_sk_…`. Registration and key minting are documented at /auth.md.
Comment résoudre
Settle the x402 challenge in the `PAYMENT-REQUIRED` header, or use the free discovery surfaces under /.well-known and /api/v1.
Comment résoudre
This operation needs an active ecentic plan. Plans are listed at /api/v1/plans and purchasable at /pricing.
Comment résoudre
Compare the request body against the operation's request schema in /openapi.json.
Comment résoudre
Fix the fields named in `errors` and retry. Field schemas live in /openapi.json.
Comment résoudre
The resource already exists or has changed. Re-read it and retry with the current state.
Comment résoudre
Wait for the number of seconds in `Retry-After`, then retry. The active policy is in the `RateLimit-Policy` header and documented at /docs/rate-limits.
Comment résoudre
Retry with exponential backoff; the failure is transient.
Comment résoudre
Retry with exponential backoff. If it persists, report it at /support with the `instance` value from this response.