HTTPステータスコード一覧
HTTPステータスコードの意味を調べます。
| 100 | Continue | リクエストの最初の部分を受信しました。クライアントは残りのリクエストを続けて送信してください。 |
| 101 | Switching Protocols | サーバーがクライアントの要求に従ってプロトコルを切り替えています(例: WebSocketへのアップグレード)。 |
| 102 | Processing | サーバーはリクエスト全体を受け付けましたが、まだ処理を完了していません(WebDAV)。 |
| 103 | Early Hints | サーバーが最終的なレスポンスを準備している間に、クライアントがリソースのプリロードを開始できるようにします。 |
| 200 | OK | リクエストは成功し、レスポンスボディに要求されたリソースが含まれています。 |
| 201 | Created | リクエストは成功し、その結果として新しいリソースが作成されました。 |
| 202 | Accepted | リクエストは処理のために受理されましたが、処理はまだ完了していません。 |
| 203 | Non-Authoritative Information | 返されたメタデータはオリジンサーバーからのものではなく、第三者やローカルキャッシュのコピーです。 |
| 204 | No Content | リクエストは成功しましたが、返す内容はありません。 |
| 205 | Reset Content | リクエストは成功しました。クライアントはリクエストを送信した文書の表示をリセットしてください。 |
| 206 | Partial Content | バイト範囲リクエストに一致する形で、リソースの一部だけが返されています。 |
| 207 | Multi-Status | 複数のステータスコードが適切な状況で、複数のリソースに関する情報を伝えます(WebDAV)。 |
| 208 | Already Reported | WebDAVバインディングのメンバーは、レスポンスの前の部分ですでに列挙されています。 |
| 226 | IM Used | サーバーは1つ以上のインスタンス操作を使用してリクエストを処理しました。 |
| 300 | Multiple Choices | このリクエストには複数の応答候補があり、クライアントがその中から1つを選ぶ必要があります。 |
| 301 | Moved Permanently | リソースはレスポンスで示された新しいURLに恒久的に移動しました。 |
| 302 | Found | リソースは一時的に別のURLにあります。今後のリクエストでも元のURLを使い続けてください。 |
| 303 | See Other | 応答はGETリクエストを使って別のURLで取得できます。 |
| 304 | Not Modified | リソースはクライアントのキャッシュヘッダーで指定されたバージョンから変更されていません。 |
| 307 | Temporary Redirect | リソースは一時的に別のURLにあります。302とは異なり、元のリクエストメソッドをそのまま使う必要があります。 |
| 308 | Permanent Redirect | リソースは新しいURLに恒久的に移動しました。元のリクエストメソッドをそのまま使う必要があります。 |
| 400 | Bad Request | 構文が不正なため、サーバーはリクエストを理解できませんでした。 |
| 401 | Unauthorized | 認証が必要ですが、認証に失敗したか、まだ提供されていません。 |
| 402 | Payment Required | 将来の使用のために予約されています。元々はデジタル決済システム向けに考案されました。 |
| 403 | Forbidden | リクエスト自体は理解されましたが、クライアントにはそのコンテンツへのアクセス権がありません。 |
| 404 | Not Found | サーバーは要求されたリソースを見つけられません。 |
| 405 | Method Not Allowed | リクエストメソッド自体は認識されていますが、対象のリソースではサポートされていません。 |
| 406 | Not Acceptable | サーバーはクライアントのAcceptヘッダーに一致するレスポンスを生成できません。 |
| 407 | Proxy Authentication Required | リクエストを続行する前に、プロキシに対する認証が必要です。 |
| 408 | Request Timeout | サーバーがクライアントからのリクエストを待っている間にタイムアウトしました。 |
| 409 | Conflict | リクエストが対象リソースの現在の状態と競合しています。 |
| 410 | Gone | 要求されたリソースはもう利用できず、恒久的に削除されました。 |
| 411 | Length Required | サーバーはContent-Lengthヘッダーを必要としていますが、リクエストにそれが含まれていませんでした。 |
| 412 | Precondition Failed | リクエストヘッダーで指定された前提条件がサーバー側で満たされませんでした。 |
| 413 | Payload Too Large | リクエストボディがサーバーが処理できる、または処理しようとするサイズより大きいです。 |
| 414 | URI Too Long | 要求されたURIがサーバーが解釈しようとする長さを超えています。 |
| 415 | Unsupported Media Type | リクエストのメディア形式がサーバーでサポートされていません。 |
| 416 | Range Not Satisfiable | リソースのサイズを踏まえると、要求されたバイト範囲を満たすことができません。 |
| 417 | Expectation Failed | サーバーはリクエストのExpectヘッダーで示された期待を満たせません。 |
| 418 | I'm a Teapot | RFC 2324でエイプリルフールのジョークとして定義された遊び心のあるステータスです。サーバーはコーヒーを淹れるべきではありません。 |
| 421 | Misdirected Request | 対象のURIに対するレスポンスを生成できないサーバーにリクエストが送信されました。 |
| 422 | Unprocessable Content | リクエストの形式は正しいものの、処理を妨げる意味的なエラーが含まれています。 |
| 423 | Locked | アクセスしようとしているリソースはロックされています(WebDAV)。 |
| 424 | Failed Dependency | このリクエストは、失敗した別のリクエストに依存していたため失敗しました(WebDAV)。 |
| 425 | Too Early | サーバーは、リプレイされる可能性のあるリクエストの処理を拒否しています。 |
| 426 | Upgrade Required | クライアントはUpgradeヘッダーで示された別のプロトコルに切り替える必要があります。 |
| 428 | Precondition Required | オリジンサーバーはリクエストが条件付きであることを要求しています。 |
| 429 | Too Many Requests | クライアントが一定時間内にリクエストを送りすぎています(レート制限)。 |
| 431 | Request Header Fields Too Large | リクエストのヘッダーフィールドが大きすぎるため、サーバーはこのリクエストを処理しません。 |
| 451 | Unavailable For Legal Reasons | 政府による検閲など、法的な理由でリソースが利用できません。 |
| 500 | Internal Server Error | サーバーはリクエストを処理できない予期しない状況に遭遇しました。 |
| 501 | Not Implemented | サーバーはリクエストを満たすために必要な機能をサポートしていません。 |
| 502 | Bad Gateway | ゲートウェイとして動作するサーバーが、上流のサーバーから不正なレスポンスを受け取りました。 |
| 503 | Service Unavailable | サーバーはリクエストを処理する準備ができていません。多くはメンテナンスや過負荷が原因です。 |
| 504 | Gateway Timeout | ゲートウェイとして動作するサーバーが、上流のサーバーから時間内にレスポンスを受け取れませんでした。 |
| 505 | HTTP Version Not Supported | リクエストで使用されているHTTPバージョンはサーバーでサポートされていません。 |
| 506 | Variant Also Negotiates | サーバーのコンテンツネゴシエーションに内部設定エラーがあります。 |
| 507 | Insufficient Storage | リクエストを完了するために必要な表現をサーバーが保存できません(WebDAV)。 |
| 508 | Loop Detected | サーバーはリクエストの処理中に無限ループを検出しました(WebDAV)。 |
| 510 | Not Extended | サーバーがリクエストを満たすには、さらなる拡張が必要です。 |
| 511 | Network Authentication Required | クライアントはネットワークにアクセスするために認証が必要です。多くはキャプティブポータルで表示されます。 |
使用例
APIレスポンスのステータスコードの意味を理解する
バックエンドAPIが返した422のような見慣れないコードを検索して、その意味と対処法をすばやく確認しましょう。
適切なリダイレクトコードを選ぶ
301と308、302と307の違いを確認して、URLを移動する際にどのリダイレクトステータスを使うべきか判断しましょう。
ブラウザのネットワークタブで見たコードを調べる
ブラウザの開発者ツールのネットワークタブで見かけたステータスコードを検索して、リクエストが失敗した理由を理解しましょう。
認証デバッグ中に401と403を区別する
「401」と「403」を並べて検索すれば、正確な違いがわかります。401はリクエストに有効な認証情報がないことを意味し、403は認証情報は有効だが、そのリソースへのアクセスが許可されていないユーザーであることを意味します。
クライアントでのレート制限の扱い方を決める
429を検索して、一定時間内のリクエストが多すぎることを意味すると確認し、APIのレスポンスに再試行前に尊重すべきRetry-Afterヘッダーが含まれているか確認しましょう。
よくある質問
この一覧のコードは実際にすべて標準ですか?
はい — このリストにはIANAの公式HTTPステータスコードレジストリに登録されている、一般的に使われているコードのみを収録しています。非標準または非公式のコードは含まれていません。
305や306のようなコードがないのはなぜですか?
305(Use Proxy)はセキュリティ上の理由で事実上廃止されており、306は使われていません。実際に遭遇する可能性が非常に低いため、実際によく使われるコードに絞って一覧を構成しています。
この説明は仕様全体や法的助言の代わりになりますか?
いいえ — これらはすばやく参照するための簡単な要約です。正確な挙動が重要な場合は、関連するRFCや最新のHTTP仕様を直接確認してください。
401と403の本当の違いは何ですか?
401 Unauthorizedは実際には「未認証」を意味し、サーバーがあなたが誰であるかを把握していない状態で、通常は認証情報が欠けているか無効な場合に発生します。403 Forbiddenは、サーバーがあなたが誰であるかを把握しているものの、たとえ有効な認証情報があってもそのリソースへのアクセス権限がないことを意味します。
リソースがなくなった場合、404と410のどちらを使うべきですか?
リソースが存在せず、かつてあったかどうかわからない(または言いたくない)場合は404 Not Foundを使います。そのリソースがかつて確実に存在していたが完全に削除されたとわかっている場合は410 Goneを使います。410はクライアントや検索エンジンにそのリソースへのリクエストを止めるよう知らせる役割があります。
リダイレクトで301、302、307、308はいつ使い分けるべきですか?
301と308は恒久的なリダイレクト、302と307は一時的なリダイレクトです。古い組(301/302)と新しい組(307/308)の違いは、307と308がリダイレクトされたリクエストでメソッドと本文の維持を保証する点で、301と302では歴史的にPOSTがGETに変わってしまうことが許容されていました。
サーバーがもっと具体的なコードではなく500を返したのはなぜですか?
500 Internal Server Errorは、未処理の例外のような予期しないサーバー側の失敗に対する汎用的な総称コードです。通常は、サーバーのエラー処理がその失敗をより具体的な4xxや5xxコードにマッピングできなかったことを意味します。実際の原因についてはサーバーのログを確認してください。