HTTPステータスコードは、要求に対する応答の意味を示す3桁の番号です。最初の1桁で大きな分類を読み、残りの番号と応答内容で状況を確かめます。
一覧は原因を断定する表ではありません。この記事では代表コードと、調査のために一緒に見る情報を整理します。
最初の1桁で応答を分類する
RFC 9110は、ステータスコードを次の五つに分類しています。
| 分類 | 大きな意味 | 調べるときの着眼点 |
|---|---|---|
| 1xx | 処理途中の情報 | 最終応答まで確認する |
| 2xx | 成功 | 何の操作が成功したか読む |
| 3xx | 転送などの追加動作 | 次に参照する先や条件を見る |
| 4xx | 要求側に関するエラー | 入力・認証・対象を確認する |
| 5xx | サーバー側のエラー | 応答した層と処理状態を確認する |
着眼点の列は調査用の整理です。たとえば4xxが返っただけで、利用者本人の操作ミスと決めつけることはできません。アプリが組み立てた要求やサーバーの設定も調査対象です。
代表コードは名称と条件を一緒に読む
登録されたコードと参照仕様はIANAの一覧から確認できます。以下は代表例です。
| コード | 名称 | 読む際のポイント |
|---|---|---|
| 200 | OK | 要求された操作の成功 |
| 201 | Created | 要求によりリソースが作成された |
| 204 | No Content | 成功し、応答コンテンツはない |
| 301 / 302 | Moved Permanently / Found | 恒久的/一時的な別URIへの誘導 |
| 304 | Not Modified | 条件付き取得で、保存済み表現を利用できる |
| 400 | Bad Request | 要求に問題があると判断された |
| 401 / 403 | Unauthorized / Forbidden | 資格情報の不足やアクセス拒否を調べる |
| 404 | Not Found | 対象の表現を見つけられない、または存在を開示しない |
| 500 | Internal Server Error | 処理を妨げる予期しない状態 |
| 502 / 504 | Bad Gateway / Gateway Timeout | 中継先の応答や待ち時間を調べる |
細部はメソッドや応答ヘッダーによって変わります。番号だけを置換した独自の意味で扱わず、利用しているAPIの仕様も確認します。
成功コードでも業務完了を確認する
仮に注文受付APIが200を返したとしても、それが注文受付・審査・出荷のどこまでを表すかはAPIの契約によります。HTTP上の成功と、後続業務の完了を同じ欄にしないことが大切です。
応答本文に処理IDや結果があるなら、予定した操作と対応するかを確認します。API側の合意内容を整理する方法はAPI設計書の書き方も参考になります。
調査では要求と応答を一組で残す
調査用には、日時、URLのパス、メソッド、コード、関連するヘッダー、要求IDを一組で残します。認証情報や個人データの実値を、そのまま問い合わせや共有ログへ貼り付けないようにします。
同じ番号でも、入口のプロキシが返したのかアプリが返したのかで確認先は変わります。再現条件を小さく整理し、どの層まで届いたかを順に追いましょう。
再試行する前に処理の性質を確認する
失敗応答を見て即座に同じ操作を繰り返すと、結果が分からない更新を重ねるおそれがあります。コードの意味、APIの再試行条件、元の操作の確定状態を確認してから次の行動を選びます。
番号・応答内容・処理の契約を揃えて読むことが、一覧を実務に使う出発点です。