【入門編】HTTPステータスコード2xx（成功）の分類と詳細な意味 – HTTPプロトコル・通信規格実践ガイド

こんにちは。ネットワークの現場でパケットの旅を追いかけ続けているエンジニアです。

皆さんは、Webブラウザで何かを検索したり、アプリでボタンを押したとき、裏側でどんなやり取りが行われているか想像したことはありますか？私たちエンジニアにとって、Webブラウザとサーバーのやり取りは、まさに「手紙の往復」そのものです。

今日は、そのやり取りの中で、サーバーが「あなたのリクエスト、無事に受け取りましたよ！」と伝えてくれる「2xx（成功）系」のステータスコードに注目してみましょう。これを知っておくと、システム開発のデバッグやエラー対応が劇的に楽になりますよ。

—

まず、ステータスコードというのは、サーバーがブラウザに対して「今回のリクエスト、どうなった？」と報告する3桁の数字のスタンプのようなものです。

「200番台」のスタンプは、どれも「成功」を意味しますが、実はその中身には「完璧に成功したのか」「とりあえず受け取ったのか」といった、絶妙なニュアンスの違いがあるんです。

郵便配達に例えながら、一つずつ紐解いていきましょう。

—

「200 OK」は、Webの世界で最も目にする、いわば「配達完了！中身も確認しました！」というスタンプです。

HTTP/1.1 200 OK
Content-Type: application/json

{
“status”: “success”,
“message”: “データをお届けしました！” // サーバーがリクエストに応えて中身を送った状態
}

—

「201 Created」は、「リクエストを受けて、新しいモノを作成しましたよ！」という報告です。

状況: 例えば、会員登録フォームで「登録」ボタンを押したときを想像してください。サーバー側で新しいユーザー情報がデータベースに保存されたとき、このステータスが使われます。
ポイント: 単に成功しただけでなく、「あなたのリクエストによって、新しく資源（リソース）が生成された」という事実に重みがあります。

HTTP/1.1 201 Created
Location: /users/12345 // 作成されたデータへのURLを添えるのがマナーです

—

「202 Accepted」は、少し慎重なサーバーが返す返事です。「リクエストは確かに受け取ったけれど、処理が完了するのはもう少し先になるかもね」という状態です。

状況: 巨大なファイルをアップロードしたり、時間がかかる重い計算を依頼したりしたときです。サーバーが「全部終わるまで待たせるとブラウザがフリーズしちゃうから、とりあえず受け付けたことだけ伝えよう」と判断したときに使います。
ニュアンス: 「手紙は預かった！今すぐ処理するから、後で結果を見に来てね！」という感覚です。

—

「204 No Content」は、ちょっとクールな返事です。「処理は完璧に終わったよ。でも、君に送る中身（データ）は特にないよ」というときですね。

状況: 例えば、「この設定を削除して」というリクエストに対して、削除が完了したことを伝えるだけの場合などです。
メリット: サーバーから無駄なデータが送られてこないので、通信の節約になります。画面を書き換える必要がない「削除」や「更新」の処理で非常によく使われます。

—

「全部200で返せばいいんじゃないの？」と思われるかもしれません。しかし、ステータスコードを正しく使い分けることは、システムが今どういう状態にあるのかを、遠くにいる相手（ブラウザや別のアプリ）に正しく伝えるための「共通言語」なのです。

1. 200 OK: ちゃんと届いたよ！
2. 201 Created: 新しいものを作ったよ！
3. 202 Accepted: 預かった！今処理中だよ！
4. 204 No Content: 完了したよ！中身はないよ！

この微妙な「ニュアンスの違い」を理解することで、ネットワークの向こう側で起きている出来事が、まるで目の前で見ているかのように手に取るようにわかるようになります。

まずは、皆さんが普段見ているWebサイトの「デベロッパーツール（F12キー）」を開いて、ネットワークタブを覗いてみてください。今日学んだスタンプたちが、パケットに乗って次々と届いている様子が見えるはずですよ。

それでは、また次回の記事でお会いしましょう！ネットワークの世界は、まだまだ奥が深いですよ。