ecentic API エラー。
ecentic APIのすべての失敗レスポンスは、HTMLページではなく、型が定義されたエラードキュメントです。コードが契約そのものです。コードは安定しており、機械で読み取れ、安全に条件分岐に使えます。
RFC 9457 · 安定したコード · 解決ヒント
problemドキュメントの形式
APIが返すすべての4xxおよび5xxで、単一のメディアタイプと単一のスキーマを使用します。
application/problem+json
レスポンスにはContent-Type: application/problem+jsonが設定されます。これは意図的にapplication/jsonではありません。このメディアタイプによって、汎用クライアントはレスポンス本文が要求したリソースではなく失敗内容を示していると判断できます。
レスポンスを確認
- type
- このリファレンス内で問題を識別するURIです。
- code
- クライアント側で分岐処理に利用できる安定した識別子です。
- title
- 人が読める短い概要です。
- status
- HTTPステータスを本文内でも繰り返し示します。
- detail
- このリクエストで発生した具体的な問題です。
- resolution
- 障害を解決するための次の手順です。
- documentation
- このレスポンスに対応するリファレンスページです。
- instance
- 判明している場合、この結果を生成したリクエストパスです。
エラーカタログ
コードは公開後に固定されます。タイトルやヒントの表現は変更される場合がありますが、コードは変更されません。
12公開済み問題コード
解決方法を確認するにはコードを開いてください。各コードには固定リンクがあります。
解決方法
Check the path against the OpenAPI document at /openapi.json or the API catalog at /.well-known/api-catalog.
解決方法
Re-read the operation in /openapi.json; the `Allow` header lists the methods this path accepts.
解決方法
Send `Authorization: Bearer ecentic_sk_…`. Registration and key minting are documented at /auth.md.
解決方法
Settle the x402 challenge in the `PAYMENT-REQUIRED` header, or use the free discovery surfaces under /.well-known and /api/v1.
解決方法
This operation needs an active ecentic plan. Plans are listed at /api/v1/plans and purchasable at /pricing.
解決方法
Compare the request body against the operation's request schema in /openapi.json.
解決方法
Fix the fields named in `errors` and retry. Field schemas live in /openapi.json.
解決方法
The resource already exists or has changed. Re-read it and retry with the current state.
解決方法
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.
解決方法
Retry with exponential backoff; the failure is transient.
解決方法
Retry with exponential backoff. If it persists, report it at /support with the `instance` value from this response.