HTTP ステータスコード

ステータスコードのカテゴリ

• 1xx 情報：暫定レスポンス——リクエスト受信済み、まだ処理中。
• 2xx 成功：リクエストが受信・理解・受理された。
• 3xx リダイレクト：リクエストを完了するために追加操作が必要。
• 4xx クライアントエラー：リクエストに誤りがあるか実行不可能。
• 5xx サーバーエラー：正常なリクエストの処理に失敗した。

API で返すステータスコードの選び方

401 か 403 か。 401 はサーバーが相手を識別できていない状態で、401 を返すサーバーは WWW-Authenticate ヘッダーも送らなければなりません（RFC 9110 §15.5.2）。403 は相手を識別したうえで操作を許可しない状態です。リソースの存在自体を知られたくない場合は、403 の代わりに 404 を返せます（§15.5.4）。

リダイレクトとメソッド。 歴史的な理由から、ブラウザーは 301 と 302 をたどるときに POST を GET に変えることがあります（§15.4.2）。307 と 308 はメソッドとボディを保持しなければなりません。フォームの POST を POST のまま転送したいときは 307 か 308 を使います。

コードとセットで返すヘッダー

JavaScript での扱い方

fetch() は 4xx や 5xx では reject しません。reject するのはネットワークエラーのときだけなので、res.ok（200〜299 で true）か res.status を確認します。

const res = await fetch('/api/orders', { method: 'POST', body });
if (res.status === 401) return redirectToLogin();
if (res.status === 429) {
  const wait = Number(res.headers.get('Retry-After') ?? 60);
  return retryAfter(wait);
}
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const order = await res.json();

制限事項

• 登録済みの 61 コード。 一覧は IANA のレジストリに沿っています。nginx の 499 や Cloudflare の 520〜526 のような特定製品だけのコードは載っていません。
• 2 つのコードは旧名称です。 一覧では 413 Payload Too Large と 422 Unprocessable Entity ですが、RFC 9110 で Content Too Large と Unprocessable Content に改名されています。
• 説明は英語のみ。 どの言語のページでも名称と説明は英語です。検索はコード・名称・英語の説明文に一致するものを探すので、「リダイレクト」では何も出ません。redirect で検索してください。