RFC 9457 問題タイプ
エラーレジストリ
/api/v1alpha1 のすべてのエラーは application/problem+json 形式のドキュメントで、type、title、status、detail、最上位の拡張メンバーである requestId を含みます。type URI は安定した機械可読エラーコードです。 トランスポート処理には status、 ドメインの動作には type、 運用サポートには requestId を使ってください。 すべての URI は下記のページに解決されます。
| 型 | ステータス | 意味 |
|---|---|---|
| bad-request | 400 | リクエストの形式が不正、またはこのエンドポイントが受け付ける内容と一致しません。 |
| validation-error | 400 | リクエストボディ内のフィールドが不足、不正、未知、または許容範囲外です。 |
| invalid-cursor | 400 | カーソルの形式が不正、またはこのAPIが発行したものではありません。 |
| ssrf-blocked | 400 | Webhook URLがHTTPSでない、またはプライベート、ループバック、リンクローカル、ユニークローカルのアドレスに解決されます。 |
| unauthorized | 401 | API キーがない、不正、期限切れ、無効、または組織に紐づいていません。 |
| forbidden | 403 | API キーは有効ですが、権限の不足、請求やトライアルの状態などにより、アカウントまたはワークスペースがこの操作を許可されていません。 |
| quota-exceeded | 402 | ワークスペースが請求クォータに達したため、リクエストは処理されませんでした。quotaDimensionがある場合は、達した上限を示します。 |
| resource-not-found | 404 | リソースが存在しない、別のワークスペースに属する、またはキーがalpha allowlist対象外です。 |
| conflict | 409 | リクエストが現在のリソースの状態と競合しています。 |
| idempotency-in-flight | 409 | 同じワークスペースとエンドポイントで、同じべき等性キー(Idempotency-Key)がすでに処理中です。 |
| precondition-failed | 412 | If-Matchの値が現在のリソースのバージョンと一致しません。 |
| unprocessable-entity | 422 | リクエストの形式は正しいものの、現在の入力またはリソースの状態には適用できません。 |
| idempotency-payload-mismatch | 422 | 同じべき等性キーを異なるペイロードで再利用しました。 |
| rate-limit-exceeded | 429 | API キーの1時間あたりのリクエスト上限を使い切りました。 |
| service-unavailable | 503 | DeepFrameが依存するサービスが一時的に利用できません。 |
| internal-error | 500 | DeepFrame側で予期しない問題が発生しました。 |