HTTPステータスコード リファレンス｜素早く検索・絞り込み可能な開発者ツール

HTTPリクエストの応答で返される各種ステータスコードの意味や典型的な用途、関連するHTTPヘッダーを素早く検索・確認できる開発者向けのリファレンスツールです。API開発やインフラ構築、デバッグ作業時に、目的のステータスコードの仕様を瞬時に把握できます。

💡 ツール概要

• インクリメンタル検索による高速ルックアップ 検索ボックスに「404」「Bad Gateway」「WebDAV」などの数値やキーワードを入力すると、ステータス名称だけでなく説明文や用途の情報も含めてリアルタイムにフィルタリングされます。
• クラス（1xx〜5xx）ごとのカテゴリ絞り込み 「2xx（成功）」「4xx（クライアントエラー）」「5xx（サーバーエラー）」などのクラス単位でワンクリックで表示を切り替え、特定のレイヤーに属するステータス群を容易に俯瞰できます。
• 実務的な詳細情報と関連ヘッダーの提示 各ステータスコードのアコーディオンを展開することで、仕様上の正確な意味に加え、「Nginxのプロキシ設定に起因するケース」「TLS 1.3のEarly Dataによるリプレイ攻撃防止」といった実用的なユースケースや、実装時に併用すべき関連ヘッダー（Retry-After、If-Match、Expect など）を確認できます。

🧐 よくある質問

Q. 4xx系と5xx系のエラーの根本的な違いは何ですか？

A. 4xx（Client Error）は、リクエストの構文が不正であったり、認証情報が不足しているなど「クライアント（送信元）側に起因するエラー」を示します。一方、5xx（Server Error）は、リクエストは正当であるものの「サーバー側で例外の発生や設定ミスにより処理に失敗した」ことを示します。システム障害の切り分けにおいて、どちら側の修正が必要かを特定するための重要な指標となります。

Q. 「301 Moved Permanently」と「302 Found」の使い分け基準を教えてください。

A. 301はリソースが「恒久的に」新しいURLへ移動したことを示し、検索エンジンのクローラーに対してSEO評価の引き継ぎを促す際に用いられます。302はメンテナンス中やログイン後のリダイレクトなど「一時的」な移動を示します。さらに、POSTメソッドを保持したままリダイレクトを行いたい場合は、近代的なプロトコル仕様である 308（恒久的）、307（一時的）を使用することが推奨されます。

📚 HTTPステータスコードの豆知識

REST APIやWebシステムの挙動を制御する上で、ステータスコードの適切な選択は非常に重要です。例えば、バックエンドの障害時に単一の「500 Internal Server Error」を汎用的に返すのではなく、一時的な過負荷やメンテナンスであれば「503 Service Unavailable」と併せて Retry-After ヘッダーを返すことで、クライアントやAPIコンシューマーに対して適切な再試行（リトライ）を制御させることができます。

また、ステータスコードの仕様は静的なものではなく、HTTPプロトコルやWeb技術の発展とともに拡張されています。RFC 2324に由来するジョーク仕様である「418 I'm a Teapot」のようなイースターエッグ的存在から、GDPRや検閲等の法的理由でブロックされたことを示す「451 Unavailable For Legal Reasons」、さらにはHTTP/2やHTTP/3の普及に伴う高度な通信制御用コードまで様々です。これらを正しく理解し実装することは、堅牢で標準規格に準拠したシステム設計に直結します。