HTTPヘッダの意味を調べる

curlのログやバグ報告に出てきたヘッダ名。実際に何を制御し、リクエスト側・レスポンス側のどちらなのかを調べます。

このガイドで使う道具

やりたいこと

API呼び出しやキャッシュの不可解な挙動の調査はヘッダを読むことから始まります。問いはいつも同じです。このヘッダは何をし、誰が送るのか。

調べ方

ヘッダ一覧を名前またはキーワードで検索します。各行にリクエスト・レスポンス・共通のどれで送られるか、1行の意味、Content-Typeのように双方向でも意味が違う例など、よくある誤解の注記が出ます。

  • request——クライアントが送る(Authorization、If-None-Match)。
  • response——サーバーが送る(ETag、Content-Security-Policy)。
  • shared——どちらでも有効(Cache-Control、Date)。

具体例

CDNがキャッシュ設定を無視しているように見えます。cacheで検索するとCache-Control(共通)、ETagとLast-Modified(応答側バリデータ)、If-Modified-SinceとIf-None-Match(要求側条件)が出ます。トレースと照合すれば、どちら側が対話の片方を忘れているか分かります。

対応範囲

実際に遭遇するヘッダに絞った一覧で、完全なレジストリよりかなり小規模です。説明は要約なので、ヘッダの連結やリスト構文の細部はRFC本文を確認してください。