ecentic API: Fehler.
Jeder Fehler in der ecentic API ist ein typisiertes Problemdokument, keine HTML-Seite. Der Code ist der Vertrag: stabil, maschinenlesbar und sicher für Verzweigungen nutzbar.
RFC 9457 · Stabile Codes · Hinweise zur Behebung
Die Struktur eines Problems
Ein Medientyp, ein Schema – bei jedem 4xx- und 5xx-Fehler, den die API zurückgibt.
application/problem+json
Antworten enthalten Content-Type: application/problem+json – bewusst nicht application/json, weil der Medientyp einem generischen Client signalisiert, dass der Body einen Fehler beschreibt und nicht die angeforderte Ressource.
Antwort lesen
- type
- Die URI, die das Problem bezeichnet und in dieser Referenz verankert ist.
- code
- Die stabile Kennung, anhand der Ihr Client unterschiedliche Abläufe steuern kann.
- title
- Eine kurze, für Menschen lesbare Zusammenfassung.
- status
- Der HTTP-Status, der im Body wiederholt wird.
- detail
- Was bei dieser konkreten Anfrage schiefgelaufen ist.
- resolution
- Der nächste Schritt zur Behebung des Fehlers.
- Dokumentation
- Die Referenzseite für die Antwort.
- Instanz
- Der Anfragepfad, der sie erzeugt hat, sofern bekannt.
Fehlerkatalog
Codes werden nach ihrer Veröffentlichung eingefroren. Titel und Hinweise können umformuliert werden, Codes nicht.
12Veröffentlichte Fehlercodes
Öffnen Sie einen Code, um die Lösung zu lesen. Jeder Code hat einen permanenten Link.
So beheben Sie das Problem
Check the path against the OpenAPI document at /openapi.json or the API catalog at /.well-known/api-catalog.
So beheben Sie das Problem
Re-read the operation in /openapi.json; the `Allow` header lists the methods this path accepts.
So beheben Sie das Problem
Send `Authorization: Bearer ecentic_sk_…`. Registration and key minting are documented at /auth.md.
So beheben Sie das Problem
Settle the x402 challenge in the `PAYMENT-REQUIRED` header, or use the free discovery surfaces under /.well-known and /api/v1.
So beheben Sie das Problem
This operation needs an active ecentic plan. Plans are listed at /api/v1/plans and purchasable at /pricing.
So beheben Sie das Problem
Compare the request body against the operation's request schema in /openapi.json.
So beheben Sie das Problem
Fix the fields named in `errors` and retry. Field schemas live in /openapi.json.
So beheben Sie das Problem
The resource already exists or has changed. Re-read it and retry with the current state.
So beheben Sie das Problem
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.
So beheben Sie das Problem
Retry with exponential backoff; the failure is transient.
So beheben Sie das Problem
Retry with exponential backoff. If it persists, report it at /support with the `instance` value from this response.