HTTPステータスコードリファレンス
要するに: 日常の開発で重要なすべてのステータスコード。それぞれの意味、使用される時期、罠(401対403、302対307)。入力しながら絞り込むことができます。
🔒 設計上プライベート: すべてはこのデバイス上のブラウザで動作します。あなたの入力がサーバーにアップロードされることは決してありません。
| コード | Name | 意味 |
|---|---|---|
| 100 | Continue | クライアントはリクエストボディを続ける必要があります |
| 101 | Switching Protocols | プロトコルアップグレードが承認されました(例:WebSocketへ) |
| 200 | OK | リクエストは成功しました。デフォルトの成功レスポンスです |
| 201 | 作成済み | 新しいリソースが作成されました(典型的なPOSTの成功) |
| 202 | 受付済み | 非同期処理のためにキューに入っています。まだ完了していません |
| 204 | No Content | 意図的に空のボディでの成功 |
| 301 | Moved Permanently | リソースには新しい恒久URLがあります。リンクを更新してください。SEO評価は移行します |
| 302 | Found | 一時的なリダイレクト(歴史的に誤用;303/307参照) |
| 303 | See Other | 別のURLへのGETへのリダイレクト(post/redirect/get) |
| 304 | Not Modified | キャッシュされたコピーはまだ有効です — ETag/Last-Modifiedで再検証してください |
| 307 | Temporary Redirect | メソッドとボディを保持する一時的なリダイレクト |
| 308 | Permanent Redirect | メソッドとボディを保持する恒久的リダイレクト |
| 400 | Bad Request | サーバーはリクエストを解析/理解できません |
| 401 | Unauthorized | 認証が必要、または失敗しました(名前とは裏腹に、未認証を意味します) |
| 403 | Forbidden | 認証済みかどうかを問わず、アクセスは拒否されます |
| 404 | Not Found | このURLにはリソースがありません |
| 405 | Method Not Allowed | このリソースではHTTPメソッドがサポートされていません |
| 406 | Not Acceptable | Acceptヘッダーに一致する表現がありません |
| 408 | Request Timeout | クライアントがリクエストの送信に時間がかかりすぎました |
| 409 | Conflict | 状態の競合、例:編集の衝突や重複作成 |
| 410 | Gone | 恒久的に削除済み(404より強い — 意図的に使用) |
| 411 | Length Required | Content-Lengthヘッダーが必要です |
| 413 | Content Too Large | リクエストボディがサーバーの制限を超えています |
| 414 | URI Too Long | URLがサーバーの制限を超えています |
| 415 | Unsupported Media Type | リクエストのContent-Typeはサポートされていません |
| 418 | I'm a Teapot | RFC 2324のジョークコード。コーヒーを淹れるのを拒否するために時々使われます |
| 422 | Unprocessable Content | 構文は問題ないがセマンティクスが検証に失敗(APIはこれが大好きです) |
| 425 | Too Early | サーバーが、再プレイされた可能性のあるリクエストの処理を望んでいません |
| 429 | Too Many Requests | レート制限に達しました — 引き下がり、Retry-Afterを尊重してください |
| 500 | Internal Server Error | 一般的なサーバー側の障害 |
| 501 | Not Implemented | サーバーはその機能をサポートしていません |
| 502 | Bad Gateway | プロキシ/ゲートウェイがアップストリームから無効な応答を受け取りました |
| 503 | Service Unavailable | 過負荷またはメンテナンスで停止中 — 多くの場合一時的で、Retry-Afterを含むことがあります |
| 504 | Gateway Timeout | プロキシ/ゲートウェイがアップストリームを待ってタイムアウトしました |
| 505 | HTTP Version Not Supported | リクエスト内のHTTPバージョンはサポートされていません |
私たちについて
ステータスコードは、すべてのレスポンスに対するサーバーの一つの数字の要約で、クラスごとにグループ化されています:1xx情報、2xx成功、3xxリダイレクト、4xxクライアントのエラー、5xxサーバーのエラー。この表は、実務で重要なニュアンスとともに、働く開発者が実際に遭遇するコードを示します。401は名前にもかかわらず未認証を意味し、403はログインに関係なく拒否、422はAPI検証の失敗、429はバックオフを要求します。列挙されていないコード(1xxのロングテールと実験的コード)は十分にまれであり、クラスだけで対処方法が分かります。
よくある質問
401 と 403 の違いは何ですか?
401:あなたが誰か分かりません(認証してください)。403:分かっていますが、それでも許可されません。
一時的なリダイレクトには302と307のどちら?
307はメソッドとボディを保持します。302は歴史的に、クライアントがPOSTをGETに切り替えることを許していました。新しい作業では307(永続的なら308)を使うべきです。