標準応答仕様
本ドキュメントに記載されているステータスコードは代表例です。 mimi API は継続的な機能追加およびインフラ改善を行っています。 互換性維持を最優先としますが、HTTP の標準仕様に準拠した応答が返却される可能性があります。 そのため、特定コードへの厳密依存ではなく、クラス(2xx/4xx/5xx)単位での処理設計を推奨します。
■ HTTP ステータスコード一覧
| Status Code | 説明 | 主な発生ケース |
|---|---|---|
| 200 OK | 正常終了 | 同期処理成功時 |
| 202 Accepted | 非同期処理受付完了 | 長時間処理ジョブ受付時 |
| 400 Bad Request | リクエスト不正 | 必須パラメータ不足、フォーマット不正 |
| 401 Unauthorized | 認証失敗 | アクセストークン無効、期限切れ |
| 403 Forbidden | 権限不足 | Application権限制限、アクセス不可 |
| 404 Not Found | リソース未存在 | 存在しないエンドポイント |
| 429 Too Many Requests | レート制限超過 | API呼び出し上限超過 |
| 500 Internal Server Error | サーバー内部エラー | 想定外例外、内部処理失敗 |
| 502 Bad Gateway | 不正なゲートウェイ | 上流サーバーからの無効な応答 |
| 503 Service Unavailable | サービス利用不可 | サーバー過負荷、メンテナンス中 |
Updated 21 days ago
