HTTPステータスコードの理解：完全リファレンス

HTTPステータスコードは、クライアントのリクエスト結果を示すためにWebサーバーが返す3桁の数字です。

ステータスコードのカテゴリ

1xx - 情報

• 100 Continue：サーバーがヘッダーを受信、クライアントはボディを送信すべき
• 101 Switching Protocols：WebSocketなどへのプロトコル切り替え

2xx - 成功

• 200 OK：標準的な成功レスポンス
• 201 Created：新しいリソースが作成された
• 204 No Content：成功だが返すコンテンツなし

3xx - リダイレクト

• 301 Moved Permanently：永久移動（SEOに好ましい）
• 302 Found：一時的なリダイレクト
• 304 Not Modified：キャッシュが有効

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

• 400 Bad Request：不正なリクエスト構文
• 401 Unauthorized：認証が必要
• 403 Forbidden：認証済みだが権限なし
• 404 Not Found：リソースが存在しない
• 429 Too Many Requests：レート制限超過

5xx - サーバーエラー

• 500 Internal Server Error：一般的なサーバーエラー
• 502 Bad Gateway：上流サーバーからの不正なレスポンス
• 503 Service Unavailable：サーバー過負荷またはメンテナンス中

API設計のベストプラクティス

1. リソース作成には200ではなく201を使用

2. ボディなしの削除成功には204を使用

3. 401 vs 403を正しく使い分け

HTTPステータスコードリファレンスツールで完全なリストを確認できます。