HTTPステータスコード一覧

HTTPステータスコードは、サーバーがリクエストの結果を説明するためにレスポンスで返す3桁の番号です。200はリクエストが成功したこと、404はページが見つからなかったこと、500はサーバーでエラーが発生したことを意味します。先頭の数字によってコードは5つのクラスに分類されます。2xxは常に成功、5xxは常にサーバー側の問題を意味するため、クラスを把握するだけで、クライアント側とサーバー側のどちらにデバッグの起点があるかが即座にわかります。

先頭の数字がクラスを定義します。1xx 情報（リクエストを受信して処理中、例：100 Continue）、2xx 成功（処理完了、例：200 OK）、3xx リダイレクト（別の場所に移動が必要、例：301 Moved Permanently）、4xx クライアントエラー（リクエストに問題あり、例：404 Not Found）、5xx サーバーエラー（サーバー側で障害発生、例：500 Internal Server Error）です。上部のツールで任意のクラスをフィルタリングすると、各コードの説明とともにそのグループだけを表示できます。

日常的に遭遇するのは、200 OK、201 Created、204 No Content、301と302のリダイレクト、304 Not Modified、400 Bad Request、401 Unauthorized、403 Forbidden、404 Not Found、429 Too Many Requests、500 Internal Server Error、502 Bad Gateway、503 Service Unavailableです。上部のツールで「よく使うコードのみ」を切り替えると、全一覧をこの短いセットに絞り込め、各コードの原因と修正方法も確認できます。

200 OKは標準的な成功レスポンスです。GETリクエストの場合はボディにリソースが返され、POSTリクエストの場合はアクションの結果が返されます。201 Createdは、POSTまたはPUTが成功して新しいリソースが作成されたことを意味します。サーバーは通常、新しいリソースのアドレスをLocationヘッダーに設定します（例：Location: /users/42）。APIでリソースを作成する場合、クライアントが新しいオブジェクトの場所を知ることができるよう、200ではなくLocationヘッダーとともに201を返すのが正しい実装です。

404はサーバーがそのURLに何も見つけられなかったことを意味します。ページが存在しない、移動された、またはリンクが壊れている状態です。修正するには、URLのタイプミスや大文字・小文字の誤りを確認し、古いアドレスから新しいアドレスへの301リダイレクトを追加し、サーバーのルーティングまたは書き換えルールを検証し、わかりやすいカスタム404ページを提供します。410 Goneと異なり、404はリソースが永久に消えたことを保証しないため、検索エンジンはクロールを続けます。MDN Web Docsは仕様をよくカバーしていますが、このツールでは一般的な原因と修正方法を各コードのすぐ横で確認できます。

301 Moved Permanentlyはリソースが恒久的に新しい場所に移ったことを伝えます。検索エンジンはランキングシグナルを新しいURLに移し、インデックスを更新します。URLを恒久的に変更する際に使用します。302 Foundは一時的な移動で、元のURLが正規URLとして維持され、ランキングも保持されます。A/Bテストやメンテナンスページなど短期間の移動に使用します。GET以外のリクエストには308（恒久的）または307（一時的）を使用してください。これらはHTTPメソッドを保持するため、ブラウザがPOSTをGETにダウングレードすることを防げます。

403 Forbiddenはサーバーがリクエストを理解したが承認を拒否していることを意味します。401と異なり、認証情報を送っても解決しません。一般的な原因は、アカウントのパーミッションやスコープ不足、サーバーのファイルパーミッションの設定ミス（例：644ではなく600が設定されているファイル）、IPブロックまたはWAFルール、インデックスファイルがない状態でのディレクトリリスティング無効化などです。アカウントのロール、ファイルのパーミッション、許可リストを確認してください。サーバーによっては、リソースの存在を明かさないために意図的に404の代わりに403を返す場合もあります。

すべて5xxのサーバー障害ですが、意味は異なります。500 Internal Server Errorは汎用的な「何かが壊れた」エラーで、通常はアプリ内のハンドリングされていない例外やバグです。502 Bad Gatewayはプロキシが上流のアプリサーバーから無効なレスポンスを受け取ったことを意味します（多くの場合クラッシュ）。503 Service Unavailableはサーバーが一時的にダウンしているか過負荷状態であることを意味し、Retry-Afterヘッダーを含めるべきです。504 Gateway Timeoutは上流に到達できたが応答が時間内に返らなかったことを意味します。実際の区別にはサーバーログから始めてください。

429は、一定時間内にリクエストが多すぎるというレート制限に達したことを意味します。サーバーは通常、待機時間を示すRetry-Afterヘッダーを返します。修正するには、そのヘッダーを尊重し、リトライ間に指数バックオフを追加し、リクエスト数を減らすためにレスポンスをキャッシュするか、上限引き上げを申請します。パブリックAPIや不正アクセスを防ぐログインエンドポイントでよく使われます。GitHub、Stripe、Twitter/XはいずれもAPIレート制限に429を使用しています。

4xxエラーはクライアント側の問題です。リクエスト自体が間違っているため、変更せずに再試行しても意味がありません（400 Bad Request、401 Unauthorized、404 Not Found）。5xxエラーはサーバー側の問題です。リクエストは完全に正しい可能性がありますが、サーバーが処理できなかった（500、502、503）ため、サーバーが回復すれば同じリクエストが成功することがあります。4xxはリクエストを修正し、5xxはサーバーを修正します。この区別はリトライロジックに重要です。指数バックオフによるリトライは5xxにのみ適用し、4xxに適用するとリクエストの枠を無駄に消費するだけです。

重要なのは、200 OK（インデックスに入れたいすべてのページはこれを返す必要があります）、301 Moved Permanently（URL移行時にランキングシグナルを新しいURLに引き継ぎます）、302 Found（一時的な移動で元のURLがランキングを維持します）、404 Not Foundと410 Gone（ページが存在しないことをクローラーに伝えます。410は恒久的な消去を意味するためインデックスからより速く削除されます）、503 Service Unavailable（計画的なメンテナンス時にGooglebotにページをインデックスから削除せず後で再訪するよう伝えます）です。

401 Unauthorizedは実際には「未認証」を意味します。本人確認ができていないため、有効な認証情報（トークン、APIキー、ログインセッション）を送ることで解決できる場合があります。サーバーはWWW-Authenticateヘッダーで応答すべきです。403 Forbiddenは認証済みであるがそのリソースへのアクセスが許可されていないことを意味します。より良い認証情報を送っても解決せず、異なる権限が必要です。覚え方：401は「あなたは誰ですか」、403は「あなたにはその権限がありません」。

4つすべてリダイレクトですが、307と308は元のHTTPメソッドとボディが保持されることを保証します。一方301と302は歴史的にクライアントがリダイレクト先でPOSTをGETに切り替えることを許可しています。そのため、通常のページリダイレクトには301（恒久的）と302（一時的）で問題ありませんが、POSTやPUTデータを受け取るエンドポイントには、メソッドを維持してデータ損失を防ぐため、恒久的な移動には308、一時的な移動には307を使用してください。

520〜530の範囲のコードは、Cloudflareとオリジンサーバーとのあいだのどこかでエラーが発生したときにCloudflareが返す非標準コードです。公式のHTTP仕様には含まれていませんが、Cloudflareを使っていると頻繁に目にします。520はオリジンが空または予期しない応答を送ってきたこと、521はオリジンが接続を拒否したこと（ダウン中またはCloudflareをブロック）、522はTCP接続タイムアウト、523はオリジンに到達不可、524はオリジンに接続できたが100秒以内に応答しなかったこと、525と526はSSLハンドシェイクと証明書エラー、530は通常1xxxコードを伴うオリジンDNSエラーを意味します。これらの番号を上部で検索すると原因と修正方法を確認できます。

MDN Web Docsは権威ある仕様リファレンスですが、ライブ検索バー、クラスフィルター、コンパクトなチートシートビューがなく、コードごとに個別のページを開く必要があります。httpstatuses.comはコードをグリッド表示しますが原因や実践的な修正方法は省略しています。restapitutorial.comはREST規約を扱いますがインタラクティブな検索機能がありません。HTTP.catはユーモアのあるサイト（各コードに猫の写真が対応）ですが、実際のデバッグには不向きです。このツールは検索可能なリファレンス、クラスフィルター、チートシートモード、わかりやすい原因と修正方法、Cloudflare 5xxコードをすべて1ページに統合し、広告なし・登録不要でオフラインでも動作します。

完全に無料です。リスト全体がページ内の静的データとして組み込まれているため、すべての検索・フィルター・参照はブラウザ内でローカルに実行されます。何もアップロードされず、ログに記録されず、サーバーに送信されることもありません。そのため、ページを開いた後はオフラインでも瞬時に動作します。登録不要、アカウント不要、レート制限なし、有料機能もありません。スマートフォンでもデスクトップでも快適に使えるプライベートで高速なリファレンスです。