Web

ステータスコード

中級

読み方:ステータスコード|英語:Status Code

サーバーからの応答状態を示す3桁の数字で、200は成功、404は未検出、500はサーバーエラーだよ。いつ使う? APIのレスポンスを処理するとき、エラーハンドリングをするとき、デバッグでネットワークタブを確認するときに見るよ。間違いやすいポイント: fetchはHTTPエラー(404や500)でもPromiseをrejectしないよ。response.okやresponse.statusを確認してエラー処理する必要があるよ。

やさしい説明

ステータスコードは、サーバーが「リクエストの結果」を3桁の数字で伝えるものです。200番台は成功、400番台はクライアントのミス、500番台はサーバーのエラーです。

レストランに例えると、200は「ご注文の品です」、404は「そのメニューはありません」、500は「厨房で火事です」のようなものです。

開発者ツールの Network タブで確認できます。エラーの原因を特定するのに役立ちます。

具体例・使い方

# よく見るステータスコード
200 OK           → 成功
201 Created      → 作成成功
301 Moved        → リダイレクト(恒久的)
400 Bad Request  → リクエストが不正
401 Unauthorized → 認証が必要
403 Forbidden    → アクセス禁止
404 Not Found    → ページが見つからない
500 Internal Server Error → サーバーエラー

いつ使う?

APIのレスポンスを処理するとき、エラーの原因を調べるとき、APIを設計するとき(適切なコードを返す)に使います。

間違いやすいポイント

❌ エラーなのに200を返す

APIでエラーが起きたのに200(成功)を返すと、フロントエンドがエラーを検知できません。適切なステータスコード(400, 404, 500等)を返しましょう。

よくある疑問

Q: よく見るステータスコードは?

A: 200(成功)、201(作成成功)、301(リダイレクト)、400(不正リクエスト)、401(認証必要)、403(禁止)、404(未検出)、500(サーバーエラー)が頻出です。

Q: 4xxと5xxの違いは?

A: 4xx=クライアント側のエラー(URLミス、認証切れ等)、5xx=サーバー側のエラー(バグ、サーバーダウン等)です。

Q: ステータスコードを確認するには?

A: 開発者ツールのNetworkタブでリクエストごとのステータスコードが確認できます。赤色表示はエラーです。

関連用語

関連ブログ記事

⚠️ 関連するエラー

❓ 関連するQ&A