レスポンス

ひとことで言うと

レスポンスは、サーバーから返ってくる「返事」です。 ページの中身、画像、APIのデータ、エラーメッセージなど、こちらが受け取る結果はみんなレスポンスに入っています。 HTTP のやり取りでは、リクエストがお願いで、レスポンスがその返答です。

たとえ話でもう少し詳しく

レスポンスは、お店で注文したあとに店員さんから品物や案内を受け取る場面に似ています。

• 注文どおりの商品を渡してくれる
• 品切れや準備中なら、その案内を返してくれる
• 決まった形式で返るので、受け取る側が判断しやすい

Webでも同じです。 ブラウザやアプリがリクエストを送ると、サーバーは結果をレスポンスとして返します。 その中には、ページ本体、JSONデータ、画像、失敗理由、状態コードなどが含まれます。

よく出る場面・使いどころ

• ブラウザでページを開いたときにHTMLが返ってくるとき
• API を呼んで一覧データや検索結果を受け取るとき
• フォーム送信後に「送信完了」やエラー案内が返るとき
• 画像やPDFをダウンロードするとき

似た言葉との違い

• リクエスト
  • リクエストは「こうしてほしい」と送るお願い
  • レスポンスは、そのお願いに対して返る結果
• HTTP
  • レスポンスは1回ごとの返答そのもの
  • HTTPは、その返答をどう返すかも含めた共通ルール
• キャッシュ
  • レスポンスは、その場で返ってくる中身
  • キャッシュは、その中身をあとで速く返せるよう一時的に持っておく仕組み

実務で気にするポイント

• 成功か失敗かを、内容だけでなく状態コードでも確認する
• エラー時に、利用者にもシステムにもわかる返し方を考える
• 同じ内容を何度も返すなら、キャッシュの使い方も見直す
• 個人情報や秘密情報をレスポンスへ出しすぎない

注意: レスポンスが返ってきたからといって、必ず期待どおりの中身とは限りません。成功に見える画面でも古い情報が混ざっていたり、エラー内容が不十分だったりするので、中身と返し方の両方を見ることが大事です。