HTTPステータスコード - 1xx〜5xxの意味と使い分け

ステータスコードとは

HTTPステータスコードは、サーバーがクライアントのリクエストをどのように処理したかを示す3桁の数字です。レスポンスの1行目（ステータスライン）に含まれます。

HTTP/1.1 200 OK
         ^^^
    ステータスコード

構成: ステータスコード + 理由フレーズ（OK、Not Foundなど）

ステータスコードのクラス

最初の1桁でカテゴリを示します：

2xx - 成功

リクエストが正常に処理されたことを示します。

主要な2xxコード

200 OK - 一般的な成功

# GETリクエスト
GET /api/users/123 HTTP/1.1

# レスポンス
HTTP/1.1 200 OK
Content-Type: application/json

{"id": 123, "name": "Alice"}

201 Created - リソース作成成功

# POSTリクエスト
POST /api/users HTTP/1.1
Content-Type: application/json

{"name": "Bob"}

# レスポンス
HTTP/1.1 201 Created
Location: /api/users/456
Content-Type: application/json

{"id": 456, "name": "Bob", "created_at": "2026-05-02T10:00:00Z"}

204 No Content - 成功（ボディなし）

# DELETEリクエスト
DELETE /api/users/123 HTTP/1.1

# レスポンス
HTTP/1.1 204 No Content

削除や更新が成功したが、返すべきコンテンツがない場合に使用します。

3xx - リダイレクト

クライアントに別のリソースへアクセスするよう指示します。

主要な3xxコード

301 vs 302 vs 307

# 301 Moved Permanently（永続的）
HTTP/1.1 301 Moved Permanently
Location: https://newdomain.com/page

# 302 Found（一時的、歴史的理由で挙動が曖昧）
HTTP/1.1 302 Found
Location: https://example.com/temp-page

# 307 Temporary Redirect（一時的、メソッド保持）
HTTP/1.1 307 Temporary Redirect
Location: https://example.com/maintenance

304 Not Modified - キャッシュ有効

# リクエスト（キャッシュ検証）
GET /api/data HTTP/1.1
If-None-Match: "abc123"

# レスポンス（変更なし）
HTTP/1.1 304 Not Modified
ETag: "abc123"

リソースが変更されていない場合、ボディを送信せずキャッシュを使うよう指示します。

4xx - クライアントエラー

クライアント側のリクエストに問題があることを示します。

主要な4xxコード

400 Bad Request - リクエスト不正

# 不正なJSONを送信
POST /api/users HTTP/1.1
Content-Type: application/json

{"name": "Alice", email: "invalid-json"}

# レスポンス
HTTP/1.1 400 Bad Request
Content-Type: application/json

{
  "error": "Invalid JSON syntax",
  "details": "Unexpected token 'e' at position 18"
}

401 vs 403 の違い

# 401 - 認証が必要
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer realm="api"

{"error": "Authentication required"}

# 403 - 権限不足
HTTP/1.1 403 Forbidden

{"error": "You do not have permission to access this resource"}

404 Not Found - リソースが存在しない

GET /api/users/99999 HTTP/1.1

HTTP/1.1 404 Not Found
Content-Type: application/json

{"error": "User not found"}

409 Conflict - リソースの競合

# メールアドレス重複
POST /api/users HTTP/1.1
Content-Type: application/json

{"email": "existing@example.com"}

# レスポンス
HTTP/1.1 409 Conflict
Content-Type: application/json

{
  "error": "Email already exists",
  "field": "email",
  "value": "existing@example.com"
}

422 Unprocessable Entity - バリデーションエラー

POST /api/users HTTP/1.1
Content-Type: application/json

{
  "name": "A",
  "email": "invalid-email",
  "age": -5
}

# レスポンス
HTTP/1.1 422 Unprocessable Entity
Content-Type: application/json

{
  "errors": [
    {"field": "name", "message": "Name must be at least 2 characters"},
    {"field": "email", "message": "Invalid email format"},
    {"field": "age", "message": "Age must be positive"}
  ]
}

429 Too Many Requests - レート制限

HTTP/1.1 429 Too Many Requests
Retry-After: 3600
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1714651200

{"error": "Rate limit exceeded. Try again in 1 hour."}

5xx - サーバーエラー

サーバー側で処理できなかったことを示します。

主要な5xxコード

500 Internal Server Error - 内部エラー

HTTP/1.1 500 Internal Server Error
Content-Type: application/json

{
  "error": "An unexpected error occurred",
  "request_id": "abc-123-xyz"
}

503 Service Unavailable - サービス利用不可

HTTP/1.1 503 Service Unavailable
Retry-After: 300

{
  "error": "Service temporarily unavailable due to maintenance",
  "estimated_recovery": "2026-05-02T12:00:00Z"
}

ステータスコードの選び方

API設計での基本方針

よくある迷いポイント

Q1: 削除済みリソースへのGETは404？410？

• 404（Not Found）が一般的
• 410（Gone）は「永久に削除された」ことを明示したい場合

Q2: 権限不足で404を返すべき？

• セキュリティ上、リソースの存在を隠したい場合は404
• 明示的に拒否を示したい場合は403

Q3: メンテナンス中は503？502？

• 503（Service Unavailable）が適切
• Retry-Afterヘッダーで復旧時刻を示す

まとめ

HTTPステータスコードはクライアントとサーバー間の共通言語です。適切なステータスコードを返すことで、エラーハンドリングやデバッグが容易になります。

関連記事

• HTTPの基本 - リクエストとレスポンスの構造
• HTTPメソッド - GET / POST / PUT / DELETE / PATCH の使い分け
• HTTPヘッダー入門 - リクエスト/レスポンスヘッダーの全体像

参考リソース

• MDN - HTTP response status codes
• RFC 9110 - HTTP Semantics (Status Codes)
• IANA - HTTP Status Code Registry
• httpstatuses.com - HTTP Status Code Reference