概要
HTTP ステータスコードは、リクエストに対するサーバーの結果を 3 桁の数字で表します。このチートシートでは、Web 開発と API 設計でよく使うコードを、原因調査やレスポンス設計の判断に使える形で整理します。
最初に覚える最小セット
| コード | まず覚える用途 |
|---|---|
200 | 取得・更新が成功した |
201 | 新しいリソースを作成した |
204 | 成功したが返す本文がない |
301 / 302 | 恒久 / 一時リダイレクト |
400 | リクエスト形式が不正 |
401 / 403 | 未認証 / 権限不足 |
404 | リソースが存在しない |
409 | 状態の競合 |
429 | レートリミット |
500 / 502 / 503 / 504 | サーバーまたは上流の問題 |
4xx は利用者やクライアント側で直せる可能性が高く、5xx はサーバー側の調査が必要です。障害調査では、ステータスコードだけでなくレスポンス本文、レスポンスヘッダー、サーバーログを合わせて確認します。
1xx 情報レスポンス
| コード | 名称 | 説明 |
|---|---|---|
100 | Continue | リクエスト継続可能 |
101 | Switching Protocols | プロトコル切り替え |
102 | Processing | 処理中（WebDAV） |
103 | Early Hints | 先行ヒント |
2xx 成功レスポンス
| コード | 名称 | 説明 |
|---|---|---|
200 | OK | リクエスト成功 |
201 | Created | リソース作成成功 |
202 | Accepted | リクエスト受理（処理未完了） |
203 | Non-Authoritative Information | 非公式情報 |
204 | No Content | 成功（レスポンスボディなし） |
205 | Reset Content | コンテンツリセット |
206 | Partial Content | 部分的コンテンツ |
207 | Multi-Status | 複数ステータス（WebDAV） |
ポイント: REST APIでは200（GET/PUT成功）、201（POST作成成功）、204（DELETE成功）を使い分けます。全て200で返すのは避けましょう。
3xx リダイレクト
| コード | 名称 | 説明 |
|---|---|---|
300 | Multiple Choices | 複数の選択肢 |
301 | Moved Permanently | 恒久的リダイレクト |
302 | Found | 一時的リダイレクト |
303 | See Other | 他を参照 |
304 | Not Modified | 未変更（キャッシュ利用可） |
307 | Temporary Redirect | 一時的リダイレクト（メソッド維持） |
308 | Permanent Redirect | 恒久的リダイレクト（メソッド維持） |
注意: 301（恒久的）と302（一時的）を混同しないように。SEO目的のURL変更には301、ログイン後リダイレクトには302を使います。307/308はHTTPメソッドを維持する点が異なります。
4xx クライアントエラー
| コード | 名称 | 説明 |
|---|---|---|
400 | Bad Request | 不正なリクエスト |
401 | Unauthorized | 認証が必要 |
402 | Payment Required | 支払いが必要（将来用） |
403 | Forbidden | アクセス禁止 |
404 | Not Found | リソースが見つからない |
405 | Method Not Allowed | 許可されていないメソッド |
406 | Not Acceptable | 受理不可 |
407 | Proxy Authentication Required | プロキシ認証が必要 |
408 | Request Timeout | リクエストタイムアウト |
409 | Conflict | 競合 |
410 | Gone | 永久に削除済み |
411 | Length Required | Content-Lengthが必要 |
412 | Precondition Failed | 前提条件エラー |
413 | Payload Too Large | ペイロードが大きすぎる |
414 | URI Too Long | URIが長すぎる |
415 | Unsupported Media Type | サポートされていないメディアタイプ |
416 | Range Not Satisfiable | 範囲指定エラー |
417 | Expectation Failed | Expectヘッダーエラー |
418 | I’m a teapot | ティーポット（ジョーク） |
422 | Unprocessable Entity | 処理できないエンティティ |
423 | Locked | ロック中（WebDAV） |
429 | Too Many Requests | リクエスト過多 |
451 | Unavailable For Legal Reasons | 法的理由で利用不可 |
実践メモ: 401（Unauthorized）は「認証されていない」、403（Forbidden）は「認証済みだが権限がない」という意味です。名前に惑わされないようにしましょう。
注意: 429（Too Many Requests）が返ってきたらレートリミットに達しています。Retry-Afterヘッダの値を確認してリトライ間隔を調整しましょう。
5xx サーバーエラー
| コード | 名称 | 説明 |
|---|---|---|
500 | Internal Server Error | サーバー内部エラー |
501 | Not Implemented | 未実装 |
502 | Bad Gateway | 不正なゲートウェイ |
503 | Service Unavailable | サービス利用不可 |
504 | Gateway Timeout | ゲートウェイタイムアウト |
505 | HTTP Version Not Supported | HTTPバージョン未サポート |
507 | Insufficient Storage | ストレージ不足（WebDAV） |
508 | Loop Detected | ループ検出（WebDAV） |
510 | Not Extended | 拡張が必要 |
511 | Network Authentication Required | ネットワーク認証が必要 |
ポイント: 502（Bad Gateway）と504（Gateway Timeout）はリバースプロキシ構成で頻出。バックエンドサーバーの応答を確認しましょう。
実践メモ: ブラウザのDevToolsのNetworkタブでステータスコードを確認できます。304（Not Modified）が多い場合はキャッシュが効いている証拠です。
よく使うステータスコード
| コード | 用途 |
|---|---|
200 | GET成功、PUT/PATCH更新成功 |
201 | POST作成成功 |
204 | DELETE成功 |
301 | SEO対策のURL変更 |
302 | ログイン後のリダイレクト |
400 | バリデーションエラー |
401 | ログインが必要 |
403 | 権限不足 |
404 | ページが存在しない |
500 | サーバー側の予期せぬエラー |
まとめ
HTTP ステータスコードは、API の利用者に「何が起きたか」と「次に何をすべきか」を伝えるための約束です。成功は 200 / 201 / 204、認証認可は 401 / 403、存在しないリソースは 404、競合は 409、制限超過は 429 という基本を押さえます。
独自の意味をステータスコードに持たせすぎると、クライアント実装や監視が複雑になります。迷った場合は RFC と MDN の定義を確認してください。
参考リソース
- MDN: HTTP response status codes - MDN 公式リファレンス
- RFC 9110: HTTP Semantics - HTTP/1.1 セマンティクス公式仕様
- IANA HTTP Status Code Registry - 公式登録レジストリ
- RFC 6585: Additional HTTP Status Codes - 428, 429, 431, 511 の定義
