HTTPステータスコード一覧

HTTPステータスコードとは

HTTPステータスコードは、クライアント（ブラウザやAPIクライアント）からのリクエストに対してサーバーが返すレスポンスの状態を示す3桁の数値です。最初の1桁でカテゴリが決まり、1xx〜5xxの5つのクラスに分類されます。適切なステータスコードを返すことは、RESTful APIの設計において非常に重要です。

1xx：情報レスポンス（Informational）

リクエストを受け取り、処理を継続中であることを示します。通常、ブラウザが自動的に処理するため開発者が直接扱うことは少ないです。

2xx：成功レスポンス（Success）

リクエストが正常に受理・処理されたことを示します。API開発で最もよく使うカテゴリです。

3xx：リダイレクション（Redirection）

リクエストの完了には追加のアクション（リダイレクト先へのアクセスなど）が必要であることを示します。SEOやURL移行時に重要です。

4xx：クライアントエラー（Client Error）

クライアント側に問題があることを示します。リクエストの内容や認証情報の不備が原因です。

5xx：サーバーエラー（Server Error）

サーバー側で処理に失敗したことを示します。サーバーの設定不備やアプリケーションのバグが原因です。

よくある質問

401と403の違いは？

401 Unauthorizedは認証が必要であることを示し、ログインやトークン提供を促します。403 Forbiddenは認証済みだがリソースへのアクセス権限がないことを示します。例えば、一般ユーザーが管理者専用ページにアクセスした場合は403が適切です。

301と308の違いは？

どちらも恒久的リダイレクトですが、301はリダイレクト時にHTTPメソッドがGETに変更される可能性があります。308はリクエストメソッドを維持したまま転送します。POST リクエストのリダイレクト先でもPOSTメソッドを維持したい場合は308を使用します。

413エラーが出たら？

ファイルアップロード時に413 Payload Too Largeが返された場合は、サーバー（Nginx: client_max_body_size、Apache: LimitRequestBody）やPHP（upload_max_filesize、post_max_size）の設定を確認してください。DevLabのしきい値テスト用ファイルを使って上限値を検証できます。