はじめに
Webアプリケーションを開発したりAPIを扱う中で、HTTPステータスコードは「サーバーからの返事」を理解するために不可欠です。
個人の備忘録程度の走り書きとなっておりますが、温かい目で見守っていただければ幸いです。
今回は、自分の開発や学習中によく出会うステータスコードについて、簡潔にまとめておきます。
HTTPステータスコードとは？
HTTPステータスコードは、クライアントのリクエストに対してサーバーが返す3桁の番号です。
- 1xx（情報）：処理中
- 2xx（成功）：成功（OK、作成されたなど）
- 3xx（リダイレクト）：別のURLに移動
- 4xx（クライアントエラー）：リクエストが不正
- 5xx（サーバーエラー）：サーバー側の問題
参考文献
よく使うステータスコード一覧
成功系（2xx）
-
200 OK：正常に処理された -
201 Created：リソースの作成成功（例：POST） -
204 No Content：成功したが返すデータがない
リダイレクト系（3xx）
-
301 Moved Permanently：恒久的に移動 -
302 Found：一時的に移動 -
304 Not Modified：キャッシュが有効、再取得不要
クライアントエラー系（4xx）
-
400 Bad Request：リクエストが不正（構文ミスなど） -
401 Unauthorized：認証が必要 -
403 Forbidden：アクセス権なし -
404 Not Found：リソースが見つからない
サーバーエラー系（5xx）
-
500 Internal Server Error：サーバー内部の一般的なエラー -
502 Bad Gateway：ゲートウェイ・プロキシのエラー -
503 Service Unavailable：一時的にサービス利用不可
活用シーンと注意点
- API開発では、ステータスコードで処理結果を伝えることが非常に重要
-
200だけで済ませず、意図に応じたコードを返すようにすると保守性が高まる - ログ分析でもステータスコードを見れば、ユーザーの失敗やサーバーの異常が分かる
まとめ
HTTPステータスコードは、Web開発の基本ながら非常に重要な知識です。
自分のアプリで「何を返すか」を明確にすることが、ユーザーにとっても開発者にとっても優しい設計になります。
今後は、カスタムエラーハンドリングやAPIのベストプラクティスにも踏み込んでいきたいです！