エラーとステータスコード
認証情報とプロンプト内容をログに残さず、HTTP ステータス、構造化エラーコード、x-request-id に基づいて Foxora API の失敗を処理します。
| ステータス | 意味 | クライアントの対応 |
|---|---|---|
400 | 無効なリクエスト | ペイロードを修正し、変更せず再試行しません。 |
401 | 認証失敗 | アカウントトークンを更新または置換します。 |
403 | 機能またはプランで拒否 | 権利と要求モデルを確認します。 |
404 | ルートまたはリソースなし | /v1 パスと識別子を確認します。 |
429 | リクエスト上限到達 | リセット案内まで待ち、同時実行数を減らします。 |
5xx | サービス障害 | 安全な作業を上限付きバックオフとジッターで再試行します。 |
不明なルートは NOT_FOUND、検証失敗は VALIDATION_ERROR、予期しない失敗は INTERNAL_ERROR を返します。上流固有のメッセージは変わるため、文章から制御フローを構築しないでください。
期待される結果: クライアントが恒久的なリクエストエラーを修正するか、サポート用のリクエスト識別子を保持しながら上限付き再試行を行います。