バックエンドの開発をしているといつもステータスコードに悩まされます。その度にググっているのですが付け焼き刃の知識なのですぐ忘れるんですよね。なので自分用に AI の結果をそのまま貼り付けました。

バックエンドエンジニアが知っておくべきHTTPステータスコード

HTTPステータスコードは、クライアントとサーバー間の通信状態を表す3桁の数字です。バックエンドエンジニアとして、以下のステータスコードは必須知識です。

1. 2xxシリーズ (成功)

200 OK

リクエストが成功し、レスポンスにデータが含まれている

GET リクエストの標準的な成功応答

201 Created

リソース作成に成功（POST成功時）

例: 新しいユーザーやエントリーの作成成功時

204 No Content

リクエストは成功したが、返すコンテンツはない

例: DELETE操作成功時など

2. 4xxシリーズ (クライアントエラー)

400 Bad Request

リクエストの構文が不正、またはバリデーションエラー

例: フォームデータの検証失敗時

401 Unauthorized

認証が必要（認証情報がない、または不正）

例: ログインが必要な API へ未認証でアクセス時

403 Forbidden

認証済みだが、権限がない

例: 管理者専用エンドポイントへの一般ユーザーアクセス時

404 Not Found

リクエストされたリソースが存在しない

例: 存在しないIDのデータ取得時

409 Conflict

リソースの現在の状態と競合する操作

例: 同じメールアドレスでユーザー登録時

422 Unprocessable Entity

リクエストは構文的に正しいが、意味的に処理できない

例: 論理的に矛盾するデータや、ビジネスルール違反時

429 Too Many Requests

クライアントからのリクエスト数が制限を超えた

例: レート制限超過時

3. 5xxシリーズ (サーバーエラー)

500 Internal Server Error

サーバー内部でエラーが発生した

例: 未処理の例外、データベースエラーなど

502 Bad Gateway

ゲートウェイやプロキシとして動作するサーバーが上流サーバーから無効なレスポンスを受けた

例: マイクロサービスアーキテクチャで別サービスがダウン時

503 Service Unavailable

サーバーが一時的に要求を処理できない

例: メンテナンス中やサーバー過負荷時

504 Gateway Timeout

ゲートウェイやプロキシが上流サーバーからレスポンスを適切な時間内に受け取れなかった

例: タイムアウト発生時

適切なステータスコードの使い分け方

以下のような基本原則で使い分けましょう：

リソースの作成

成功: 201 Created

検証エラー: 400 Bad Request または 422 Unprocessable Entity

認証エラー: 401 Unauthorized

権限エラー: 403 Forbidden

リソースの取得

成功: 200 OK

存在しない: 404 Not Found

認証エラー: 401 Unauthorized

権限エラー: 403 Forbidden

リソースの更新

成功: 200 OK または 204 No Content

検証エラー: 400 Bad Request

存在しない: 404 Not Found

リソースの削除

成功: 204 No Content

存在しない: 404 Not Found または 204 No Content（冪等性を保つため）

正確なHTTPステータスコードの使用は、APIの品質と使いやすさを大きく向上させます。

ずっとこの表に頼ってしまいそう。。。

#ステータスコード