HTTPヘッダーは、要求や応答に付ける追加情報です。本文の形式、希望する応答形式、認証、キャッシュの条件などを伝えます。本文そのものや、処理結果を表すステータスコードとは役割が異なります。
APIやWebの通信を読むときは、まず「誰が送ったどの情報か」を分けると整理できます。
要求・応答・本文を分けて読む
RFC 9110は、HTTPメッセージのヘッダーフィールドとコンテンツを区別しています。
| 要素 | 主な役割 | 例 |
|---|---|---|
| 要求ヘッダー | クライアントの希望や条件を送る | Acceptなど |
| 応答ヘッダー | サーバー側の応答情報を伝える | ETagなど |
| 本文 | 実際に送る表現や入力内容 | HTML、JSONなど |
同じフィールド名が要求と応答の両方で使われる場合もあるため、名前だけで送信方向を決めつけません。
Content-TypeとAcceptを混同しない
Content-Typeは、そのメッセージで扱う表現のメディアタイプを示します。Acceptは、クライアントが応答として受け取ることを希望する形式を伝える際に使います。
仮にJSONを送ってJSONを受け取りたいAPIでも、送信する本文の形式と、希望する応答の形式は別の情報です。ヘッダーの値だけをJSONに変えても、本文の構造が自動的に変換されるわけではありません。
フィールド名と値の規則を区別する
HTTPのフィールド名は大文字・小文字を区別しません。一方、値の解釈は各フィールドの仕様に従います。すべての値を小文字へ直してよい、といった一括処理は避けます。
また、同じ名前のフィールドを常にカンマで結合してよいわけではありません。受け取った情報を転送・保存するときは、そのフィールドが持つ形式と意味を確認してください。
観測する場所によって見える情報が変わる
ブラウザ、プロキシ、アプリの間では、ヘッダーが追加・変更されることがあります。クライアントで見た値と、アプリが受け取った値が同じかを調べる際は、要求IDや時刻を合わせます。
認証やCookieに関わる値は機密情報を含むため、通信の記録をそのまま外部へ共有しないようにします。情報の種類と必要な共有範囲を先に判断します。
コードとヘッダーと本文を合わせて判断する
ステータスコードは結果、ヘッダーは条件や補足、本文は内容という役割を出発点にすると、通信の読み違いを減らせます。全体の分類はHTTPステータスコード一覧、APIの合意事項はAPI設計書へ整理しましょう。