> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qumo-deploy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# エラーコード

> Qumo Deploy の API が返す HTTP エラーの読み方と、正式な一覧への案内です。

# エラーコード

> [!NOTE]
>
> HTTP エラーコードの\*\*正式な一覧は[英語版のエラーコードリファレンス](https://docs.qumo-deploy.com/guides/error-codes.md)\*\*です。コードやその返される場面が変わったときは英語版が先に更新されるため、実装の判断には英語版を参照してください。このページは読み方の要点だけをまとめています。

## エラーレスポンスの形

API はエラー時に HTTP ステータスコードと、`error` フィールドに英語のメッセージを含む JSON を返します。

```json theme={null}
{"error": "project not found"}
```

コンソールでは、このメッセージがコンソールの表示言語（日本語または英語）で表示されます。プログラムから扱う場合は、メッセージの文言ではなく**ステータスコード**で分岐してください。

## ステータスコードの分類

| 分類 | 対処の考え方 |
| :- | :- |
| クォータとエンタイトルメント | プランのアップグレードが必要なエラーと、時間をおけば回復するレート制限は別のコードです。レート制限は指数バックオフで再試行します。 |
| 認証と認可 | クレデンシャルがない・無効な場合と、クレデンシャルは有効でも権限が足りない場合は別のコードです。 |
| クライアントエラー | リクエストの形式や内容、リソースの有無、状態の競合を示します。リクエストを直してから送り直します。 |
| サーバーエラー | サーバー側の障害です。再試行できます。 |

各コードとそれが返される場面は、[英語版のエラーコードリファレンス](https://docs.qumo-deploy.com/guides/error-codes.md)を参照してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.