API ecentic: errori.
Ogni errore dell'API di ecentic è un documento problem tipizzato, non una pagina HTML. Il codice è il contratto: è stabile, leggibile da macchina e sicuro da usare nelle diramazioni logiche.
RFC 9457 · Codici stabili · Suggerimenti di risoluzione
La struttura di un problema
Un solo media type, un solo schema, su ogni risposta 4xx e 5xx restituita dall'API.
application/problem+json
Le risposte includono Content-Type: application/problem+json — deliberatamente non application/json, perché il media type permette a un client generico di capire che il body descrive un errore e non la risorsa richiesta.
Leggi la risposta
- type
- L’URI che identifica il problema, ancorato a questo riferimento.
- code
- L’identificatore stabile su cui il tuo client può basare la logica condizionale.
- title
- Un breve riepilogo leggibile dalle persone.
- status
- Lo stato HTTP, ripetuto nel body.
- detail
- Cosa è andato storto in questa specifica richiesta.
- resolution
- Il passaggio successivo per risolvere l’errore.
- documentation
- La pagina di riferimento per la risposta.
- instance
- Il percorso della richiesta che lo ha generato, quando noto.
Catalogo degli errori
I codici vengono congelati una volta pubblicati. Titoli e suggerimenti possono essere riformulati; i codici no.
12Codici problema pubblicati
Apri un codice per leggerne la risoluzione. Ogni codice ha un link permanente.
Come risolvere
Check the path against the OpenAPI document at /openapi.json or the API catalog at /.well-known/api-catalog.
Come risolvere
Re-read the operation in /openapi.json; the `Allow` header lists the methods this path accepts.
Come risolvere
Send `Authorization: Bearer ecentic_sk_…`. Registration and key minting are documented at /auth.md.
Come risolvere
Settle the x402 challenge in the `PAYMENT-REQUIRED` header, or use the free discovery surfaces under /.well-known and /api/v1.
Come risolvere
This operation needs an active ecentic plan. Plans are listed at /api/v1/plans and purchasable at /pricing.
Come risolvere
Compare the request body against the operation's request schema in /openapi.json.
Come risolvere
Fix the fields named in `errors` and retry. Field schemas live in /openapi.json.
Come risolvere
The resource already exists or has changed. Re-read it and retry with the current state.
Come risolvere
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.
Come risolvere
Retry with exponential backoff; the failure is transient.
Come risolvere
Retry with exponential backoff. If it persists, report it at /support with the `instance` value from this response.