HTTP ステータスコード：開発者のための完全リファレンスガイド

HTTPステータスコードはサーバーがリクエストに対して返す3桁の数字です。この完全なHTTPステータスコードリファレンスは実践で遭遇するすべてのコードを網羅しています。

HTTPステータスコードツールで即座に確認 →

1xx — 情報レスポンス

サーバーがリクエストを受信し処理を続けていることを示します。

2xx — 成功

最も一般的なカテゴリ。リクエストが正常に処理されました。

3xx — リダイレクト

クライアントが追加のアクションを実行する必要があります。

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

問題はクライアント側にあります。

5xx — サーバーエラー

サーバーがリクエストを処理できませんでした。

API ステータスコードのベストプラクティス

適切なステータスコードでAPIをより直感的に。

// REST API Status Code Guidelines

// Creating a resource
POST /api/users → 201 Created (with Location header)

// Successful read
GET /api/users/123 → 200 OK

// Successful update
PUT /api/users/123 → 200 OK (with updated resource)
PATCH /api/users/123 → 200 OK

// Successful delete
DELETE /api/users/123 → 204 No Content

// Validation error
POST /api/users (invalid data) → 422 Unprocessable Entity
{
  "error": "Validation failed",
  "details": [
    { "field": "email", "message": "Invalid email format" }
  ]
}

// Authentication required
GET /api/admin → 401 Unauthorized
{ "error": "Authentication required" }

// No permission
GET /api/admin (as regular user) → 403 Forbidden
{ "error": "Insufficient permissions" }

// Resource not found
GET /api/users/999 → 404 Not Found
{ "error": "User not found" }

// Rate limit exceeded
GET /api/search → 429 Too Many Requests
Retry-After: 60
{ "error": "Rate limit exceeded", "retry_after": 60 }

よくあるデバッグシナリオ

ステータスコードはデバッグの最初の手がかりです。

CORS Errors (Browser shows "blocked by CORS")

The browser blocks the request, but the actual HTTP status may be hidden. Check server logs. Ensure your server sends the correct Access-Control-Allow-Origin, Access-Control-Allow-Methods, and Access-Control-Allow-Headers headers.

502 Bad Gateway on Deployment

Your reverse proxy (Nginx, Cloudflare) can't reach your application server. Check: Is the app process running? Is it listening on the correct port? Are there firewall rules blocking the connection?

# Check if your app is running
ps aux | grep node

# Check if it's listening on the expected port
netstat -tlnp | grep 3000

# Check Nginx error logs
tail -f /var/log/nginx/error.log

504 Gateway Timeout

The upstream server is too slow. Common causes: slow database queries, external API timeouts, or large file processing. Solutions: optimize queries, add timeouts to external calls, use background jobs for heavy tasks.

429 Rate Limiting

// Implementing exponential backoff in JavaScript
async function fetchWithRetry(url, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url);
    if (response.status !== 429) return response;

    const retryAfter = response.headers.get('Retry-After');
    const delay = retryAfter
      ? parseInt(retryAfter) * 1000
      : Math.pow(2, i) * 1000; // 1s, 2s, 4s

    await new Promise(r => setTimeout(r, delay));
  }
  throw new Error('Max retries exceeded');
}

よくある質問

401と403の違いは？

401 = 認証が不足。403 = 認証済みだが権限なし。

200と201の使い分けは？

200は成功、201は新しいリソースの作成時。

418の意味は？

1998年のエイプリルフール。サーバーはティーポットです。

SEOにおける301と302の違いは？

301 = 恒久的（SEO引継ぎ）。302 = 一時的。

429の対処法は？

Retry-Afterヘッダーを確認し、指数バックオフを実装。

HTTPステータスコードの理解は基本です。ツールをご活用ください。

HTTPステータスコードツールで確認 →