HTTPステータスコード一覧

HTTPステータスコードの意味を調べます。

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