Web・ネットワーク
PR

HTTPヘッダーの読み方|リクエストとレスポンスの主なヘッダーをcurlで確かめる

HTTPヘッダーの読み方|リクエストとレスポンスの主なヘッダーをcurlで確かめる
hr
記事内に商品プロモーションを含む場合があります

API が 415 エラーを返す、日本語のページが文字化けする、リダイレクト先が分からない。こうしたトラブルの原因の多くは、本文ではなく HTTP ヘッダーに書かれています。

この記事では、受け取ったヘッダーをそのまま表示する小さな Python サーバーを自分の PC(127.0.0.1)で動かし、curl・Edge・Python から送ったヘッダーを実際に見ながら、HTTP メッセージの形と主なヘッダーの意味を解説します。仕様は RFC 9110・RFC 9112 と MDN の原文で確認しました(2026 年 10 月時点)。

HTTP ヘッダーとは

HTTP では、ブラウザーやプログラム(クライアント)が「リクエスト」を送り、サーバーが「レスポンス」を返します。どちらのメッセージも、1 行目・ヘッダー・空行・本文の 4 つの部分でできています(RFC 9112 2.1)。ヘッダーは「名前: 値」の行の集まりで、本文についての説明や、相手へのお願いを伝えます。

curl で POST /api/todos を送ったときのリクエストとレスポンスを左右に並べた図。リクエストは、リクエスト行 POST /api/todos HTTP/1.1、ヘッダー(Host・User-Agent・Accept・Content-Type・Content-Length)、空行、本文 title が milk の JSON。レスポンスは、ステータス行 HTTP/1.1 201 Created、ヘッダー(Server・Date・Content-Type・Content-Length)、空行、本文 created の JSON。
図 1:リクエストとレスポンスはどちらも 1 行目・ヘッダー・空行・本文の形
  • 1 行目:リクエストでは「メソッド パス HTTP のバージョン」(リクエスト行)、レスポンスでは「HTTP のバージョン ステータスコード 説明」(ステータス行)
  • ヘッダー:1 行に 1 つ、「Content-Type: application/json」のように書く
  • 空行:ヘッダーの終わりの目印。実際には改行コード CR LF(\r\n)が 2 回続く
  • 本文:HTML や JSON などのデータ。GET のリクエストのように本文がないこともある

Python の urllib で、通信の中身を表示する設定(urllib.request.HTTPHandler(debuglevel=1))にして POST を送ったときに、実際に流れたバイト列は次のとおりです。ヘッダーの行が \r\n で区切られ、最後に \r\n\r\n(空行)が来て、そのあとに本文が続きます。

send: b'POST /api/todos HTTP/1.1\r\nAccept-Encoding: identity\r\nContent-Length: 2\r\nHost: 127.0.0.1:8131\r\nUser-Agent: Python-urllib/3.12\r\nContent-Type: application/json\r\nAccept-Language: ja\r\nConnection: close\r\n\r\n'
send: b'{}'

ヘッダー名は大文字・小文字を区別しない

RFC 9110 5.1 に「Field names are case-insensitive」とあるとおり、Content-Type と content-type は同じヘッダーです。HTTP/2 では、ヘッダー名は小文字に変換して送ることになっています(RFC 9113 8.2)。そのため、プログラムでヘッダーを読むときは、大文字・小文字を区別しない方法で取り出します(Python の self.headers.get("content-type") や res.headers["content-type"] はどちらの書き方でも取り出せます)。

一方、値の大文字・小文字の扱いはヘッダーごとに決まっています。たとえば Content-Type の charset の名前(utf-8 と UTF-8)は区別しません(RFC 9110 8.3.2)が、Cookie の値や認証トークンは 1 文字でも違えば別の値です。また、名前とコロンの間に空白を入れてはいけません(RFC 9112 5.1。サーバーは 400 で拒否しなければならないとされています)。

練習用のサーバーを自分の PC で動かす

ヘッダーを観察するために、Python の標準ライブラリだけで動くサーバーを用意します。次の内容を header_server.py という名前で保存してください。/headers は受け取ったリクエストヘッダーをそのまま返し、ほかのパスはレスポンスヘッダーの例を返します。

import json
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer

HTML = "<!doctype html><title>テスト</title><p>こんにちは、世界</p>".encode("utf-8")


class Handler(BaseHTTPRequestHandler):
    protocol_version = "HTTP/1.1"

    def reply(self, status, body, ctype, extra=None):
        self.send_response(status)
        self.send_header("Content-Type", ctype)
        self.send_header("Content-Length", str(len(body)))
        for name, value in (extra or {}).items():
            self.send_header(name, value)
        self.end_headers()
        if self.command != "HEAD":
            self.wfile.write(body)

    def do_GET(self):
        if self.path == "/headers":  # 受け取ったリクエストヘッダーをそのまま返す
            text = f"{self.requestline}\n{self.headers}"
            self.reply(200, text.encode("utf-8"), "text/plain; charset=utf-8")
        elif self.path == "/utf8":  # charset あり
            self.reply(200, HTML, "text/html; charset=utf-8")
        elif self.path == "/nocharset":  # charset なし(UTF-8 の日本語)
            self.reply(200, HTML, "text/html")
        elif self.path == "/old":  # 転送先を Location で知らせる
            self.reply(301, b"", "text/plain", {"Location": "/headers"})
        elif self.path == "/login":  # Cookie を渡す
            self.reply(200, b"ok\n", "text/plain",
                       {"Set-Cookie": "sid=abc123; HttpOnly; SameSite=Lax; Path=/",
                        "Cache-Control": "no-store"})
        else:
            self.reply(404, b"not found\n", "text/plain")

    do_HEAD = do_GET

    def do_POST(self):
        if self.path != "/api/todos":
            return self.reply(404, b"not found\n", "text/plain")
        length = int(self.headers.get("Content-Length", 0))
        body = self.rfile.read(length)
        ctype = self.headers.get_content_type()  # 大文字小文字を区別せずに取り出す
        if ctype != "application/json":
            msg = {"error": f"Content-Type must be application/json (got {ctype})"}
            return self.reply(415, json.dumps(msg).encode("utf-8"),
                              "application/json")
        data = json.loads(body)
        self.reply(201, json.dumps({"created": data}).encode("utf-8"),
                   "application/json")


ThreadingHTTPServer(("127.0.0.1", 8131), Handler).serve_forever()

保存したフォルダーで PowerShell を開き、次のコマンドで起動します。127.0.0.1 で待ち受けるので、自分の PC からしかアクセスできません。止めるときは、起動した画面で Ctrl+C を押します。以下の結果は Windows 11、Python 3.12.6、Windows 標準の curl 8.21.0、Microsoft Edge 155 で確認しました。

py header_server.py

curl でヘッダーを見る(-v・-i・-I)

別の PowerShell を開いて、curl でアクセスします(PowerShell 5.1 では curl ではなく curl.exe と書きます)。-v を付けると、送ったリクエスト(行頭が「>」)と受け取ったレスポンス(行頭が「<」)の両方が表示されます。

curl.exe -v http://127.0.0.1:8131/utf8
> GET /utf8 HTTP/1.1
> Host: 127.0.0.1:8131
> User-Agent: curl/8.21.0
> Accept: */*
>
< HTTP/1.1 200 OK
< Server: BaseHTTP/0.6 Python/3.12.6
< Date: Fri, 23 Oct 2026 07:06:57 GMT
< Content-Type: text/html; charset=utf-8
< Content-Length: 70
<
<!doctype html><title>テスト</title><p>こんにちは、世界</p>

(「*」で始まる接続の情報は省略しています。)「>」だけの行と「<」だけの行が、それぞれの空行です。-i はレスポンスのヘッダーと本文を、-I はヘッダーだけ(HEAD メソッド)を表示します。オプションの詳しい使い方は「curlコマンドの使い方」で解説しています。

主なリクエストヘッダー

クライアントからサーバーへ送るヘッダーのうち、よく目にするものをまとめます。

ヘッダー意味例
Host接続先のホスト名とポート。HTTP/1.1 では必ず送る(RFC 9110 7.2)Host: 127.0.0.1:8131
User-Agent送り手のプログラムの名前とバージョンUser-Agent: curl/8.21.0
Accept受け取りたいデータの形式Accept: */*(何でもよい)
Accept-Language受け取りたい言語の希望Accept-Language: ja,en;q=0.9
Content-Type送る本文の形式(POST などで本文があるとき)Content-Type: application/json
Content-Length本文の大きさ(バイト数)Content-Length: 17
Authorization認証情報(トークンなど)Authorization: Bearer ...
Cookie以前サーバーから受け取った Cookie を返すCookie: sid=abc123
RefererどのページからのリクエストかReferer: http://127.0.0.1:8131/top

curl の -H でヘッダーを足し、-b で Cookie、-e で Referer を送ってみます。-H "User-Agent:" のように値を空にすると、curl はそのヘッダーを送らなくなります。

curl.exe -s -H "User-Agent:" -H "Authorization: Bearer test-token" -b "sid=abc123" -e "http://127.0.0.1:8131/top" http://127.0.0.1:8131/headers
GET /headers HTTP/1.1
Host: 127.0.0.1:8131
Accept: */*
Referer: http://127.0.0.1:8131/top
Cookie: sid=abc123
Authorization: Bearer test-token

User-Agent が消え、指定した 3 つのヘッダーがサーバーに届きました。Authorization の値はパスワードと同じ扱いが必要です。-v の出力にもそのまま表示されるので、ログや質問サイトに貼るときは必ず消してください。Referer は英単語 referrer のつづり間違いがそのまま仕様になったもので、MDN にもそう書かれています。Cookie の仕組みは「Cookieとセッションの仕組み」で詳しく解説しています。

ブラウザー(Edge)が送るヘッダー

ヘッドレスモード(画面を出さないモード)の Edge で http://127.0.0.1:8131/headers を開いたとき、サーバーが受け取ったヘッダーは次のとおりでした。

GET /headers HTTP/1.1
Host: 127.0.0.1:8131
Connection: keep-alive
sec-ch-ua: "Microsoft Edge";v="155", "Chromium";v="155", "Not(A:Brand";v="24"
sec-ch-ua-mobile: ?0
sec-ch-ua-platform: "Windows"
Upgrade-Insecure-Requests: 1
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/155.0.0.0 Safari/537.36 Edg/155.0.0.0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7
Sec-Fetch-Site: none
Sec-Fetch-Mode: navigate
Sec-Fetch-User: ?1
Sec-Fetch-Dest: document
Accept-Encoding: gzip, deflate, br, zstd
Accept-Language: ja,en;q=0.9,en-GB;q=0.8,en-US;q=0.7

curl よりずっと多くのヘッダーが付いています。q=0.9 は希望の強さで、0 から 1 の値で 1 がいちばん強く、書かないときは 1 とみなされます(RFC 9110 12.4.2)。つまり Accept-Language は「日本語がいちばんよく、次に英語」という意味です。User-Agent の「HeadlessChrome」はヘッドレスモードで動かしたためで、画面ありの普段の Edge が送る値はここでは確かめていません。sec-ch-ua や Sec-Fetch-* は、ブラウザーが自動で付けるヘッダーです。

Python(urllib)が送るヘッダー

Python の標準ライブラリ urllib.request では、Request の headers= に辞書を渡してヘッダーを付けます。次の内容を show_headers.py として保存します。

import urllib.request

req = urllib.request.Request(
    "http://127.0.0.1:8131/headers",
    headers={"Accept": "text/plain", "Accept-Language": "ja"},
)
with urllib.request.urlopen(req, timeout=5) as res:
    print(res.status, res.headers["content-type"])
    print(res.headers.get_content_charset())
    print(res.read().decode("utf-8"))
py show_headers.py
200 text/plain; charset=utf-8
utf-8
GET /headers HTTP/1.1
Accept-Encoding: identity
Host: 127.0.0.1:8131
User-Agent: Python-urllib/3.12
Accept: text/plain
Accept-Language: ja
Connection: close

指定しなかった User-Agent には Python-urllib/3.12 が自動で付きました。レスポンスのヘッダーは小文字の "content-type" でも取り出せています。urllib と requests の使い分けは「PythonでHTTPリクエストを送る方法」を参考にしてください。

主なレスポンスヘッダー

ヘッダー意味例
Content-Type本文の形式と文字コード(charset)text/html; charset=utf-8
Content-Length本文のバイト数Content-Length: 70
Locationリダイレクト先(3xx のとき)Location: /headers
Set-Cookieブラウザーに Cookie を保存させるsid=abc123; HttpOnly; ...
Cache-Controlキャッシュしてよいか・何秒使えるかno-store、max-age=3600
Serverサーバーのソフトウェア名BaseHTTP/0.6 Python/3.12.6

Content-Length は文字数ではなくバイト数です(RFC 9110 8.6)。練習用サーバーの HTML は 48 文字ですが、UTF-8 では日本語 1 文字が 3 バイトなので 70 になっています。

リダイレクトと Cookie の例です。

curl.exe -i http://127.0.0.1:8131/old
HTTP/1.1 301 Moved Permanently
Server: BaseHTTP/0.6 Python/3.12.6
Date: Fri, 23 Oct 2026 07:06:57 GMT
Content-Type: text/plain
Content-Length: 0
Location: /headers

301 の行き先は Location に書かれています。/headers のような相対的な書き方も許されていて、リクエストした URL を基準に解決されます(RFC 9110 10.2.2)。curl は -L を付けたときだけ Location の先へ移動します。

curl.exe -i http://127.0.0.1:8131/login
HTTP/1.1 200 OK
Server: BaseHTTP/0.6 Python/3.12.6
Date: Fri, 23 Oct 2026 07:06:57 GMT
Content-Type: text/plain
Content-Length: 3
Set-Cookie: sid=abc123; HttpOnly; SameSite=Lax; Path=/
Cache-Control: no-store

ok

同じ名前のヘッダーは、ふつうはカンマでつないで 1 つにまとめられますが、Set-Cookie は例外で、Cookie ごとに別の行で送られます(RFC 9110 5.3)。Cache-Control の値の意味は「HTTPキャッシュの仕組み」で解説しています。Server ヘッダーについて RFC 9110 10.2.4 は、細かすぎる値は内部の情報を明かし、攻撃者を(わずかに)助けるおそれがあると注意しています。ステータスコード(200・301・415 など)の意味は「HTTPステータスコード検索」で調べられます。

実例 1:charset がないと文字化けする

練習用サーバーの /utf8 と /nocharset は、まったく同じ UTF-8 の HTML を返します。違いは Content-Type に ; charset=utf-8 があるかないかだけです。ヘッドレスの Edge で開いたときの本文(<p> の中身)は次のようになりました。

URLContent-TypeEdge での表示
/utf8text/html; charset=utf-8こんにちは、世界
/nocharsettext/html縺薙s縺ォ縺。縺ッ縲∽ク也阜

文字化けした文字列は、Python で「こんにちは、世界」の UTF-8 のバイト列を Shift_JIS(cp932)として読んだ結果と一致しました。charset がないため、Edge が UTF-8 だと判断できず、別の文字コードで読んだことが分かります(どの文字コードで読むかは、ブラウザーや言語の設定によって変わることがあります)。

直し方は、サーバーが Content-Type: text/html; charset=utf-8 を返すことです。HTML の先頭に <meta charset="utf-8"> を書くことも併せて行うと、ファイルを直接開いたときも正しく表示されます。文字化けの仕組みは「UTF-8とは?」で解説しています。

実例 2:Content-Type を付け忘れた POST

JSON を送る API で多いのが、本文は JSON なのに Content-Type を付け忘れる間違いです。中身が {"title": "milk"} の todo.json を用意し、-H なしで送ってみます。

curl.exe -i -d "@todo.json" http://127.0.0.1:8131/api/todos
HTTP/1.1 415 Unsupported Media Type
Server: BaseHTTP/0.6 Python/3.12.6
Date: Fri, 23 Oct 2026 07:06:57 GMT
Content-Type: application/json
Content-Length: 90

{"error": "Content-Type must be application/json (got application/x-www-form-urlencoded)"}

curl の -d は、何も指定しないと Content-Type: application/x-www-form-urlencoded(HTML のフォームの形式)を付けて送ります(-v で確認できます)。サーバーは「JSON ではない」と判断して 415(Unsupported Media Type)を返しました。415 は、本文の形式がサポートされていないため処理を断るときのステータスコードで、原因として Content-Type が挙げられています(RFC 9110 15.5.16)。

curl.exe -i -H "Content-Type: application/json" -d "@todo.json" http://127.0.0.1:8131/api/todos
HTTP/1.1 201 Created
Server: BaseHTTP/0.6 Python/3.12.6
Date: Fri, 23 Oct 2026 07:06:57 GMT
Content-Type: application/json
Content-Length: 30

{"created": {"title": "milk"}}

Content-Type を付けると 201 Created になりました。-H "content-type: application/json" と小文字で書いても 201 になることも確かめました。サーバーによっては 415 ではなく 400 を返したり、本文を空として扱ったりするので、「送ったはずのデータが届いていない」ときは、まず Content-Type を確認しましょう。

Python の urllib でも、data= に JSON の bytes を渡しただけでは Content-Type がフォームの形式になり、このサーバーでは 415 が返りました。headers={"Content-Type": "application/json"} を付けると 201 になります(コードは「PythonでHTTPリクエストを送る方法」の POST の例と同じ形です)。

セキュリティに関係するレスポンスヘッダー

サーバーが返すことで、ブラウザーに安全のための動作をさせるヘッダーがあります。MDN の説明をもとに、役割をまとめます。

ヘッダー何をしてくれるか値の例
X-Content-Type-OptionsContent-Type を無視して中身から形式を推測する動作(MIME スニッフィング)を止める。スクリプトやスタイルシートとして読み込むとき、形式が合わなければブロックするnosniff
Content-Security-Policyそのページが読み込んでよいスクリプトや画像などの出どころを決める。XSS の被害を抑える助けになるdefault-src 'self'(同じオリジンからだけ)
Strict-Transport-Securityこの後はこのホストに HTTPS だけで接続させる(HSTS)。HTTP で送っても無視されるmax-age=31536000; includeSubDomains
Referrer-PolicyReferer ヘッダーにどこまでの情報を入れるかを決めるstrict-origin-when-cross-origin

MDN によると、strict-origin-when-cross-origin は、ポリシーを指定しないときの既定の動作でもあります。同じオリジンへはパスとクエリまで、別のオリジンへはオリジン(https://example.com の部分)だけを送り、HTTPS から HTTP へは Referer を送りません。これらのヘッダーは「付ければ安全」というものではなく、XSS 対策の基本(出力時のエスケープなど)と組み合わせて使います。CSP の使いどころは「XSSとは?」、HSTS は「HTTPとHTTPSの違い」で解説しています。

Edge の開発者ツールでヘッダーを見る

ブラウザーで開いたページのヘッダーは、開発者ツールの Network ツールで確認できます。手順は Microsoft の公式ドキュメント(Inspect network activity)に基づくもので、この記事では実際の画面は確認していません。日本語の表示では名前が異なる場合があります。

  1. Edge で調べたいページを開く
  2. ページの上で右クリックし、「Inspect」を選ぶ(日本語表示でのメニュー名は確認していません)。開発者ツールが開く
  3. 開発者ツールの上部にある「Network」タブを選ぶ(見当たらないときは「More tools」ボタンから開く)
  4. ページを再読み込みする。開発者ツールを開いた後の通信だけが記録される
  5. 一覧のいちばん上(ふつうはページの HTML)をクリックする
  6. 右側に表示される「Headers」パネルで、リクエストヘッダーとレスポンスヘッダーを確認する

API の呼び出しが失敗するときも、ここで実際に送られた Content-Type や Authorization、返ってきたステータスコードを確かめられます。

よくある間違い

間違い起きること直し方
JSON を送るのに Content-Type を付けない415 になる、またはデータが空として扱われるContent-Type: application/json を付ける
テキストを返すのに charset を付けないブラウザーで文字化けするtext/html; charset=utf-8 のように付ける
Content-Length を文字数で計算する日本語を含むと本文が途中で切れるエンコードした後のバイト数を使う
ヘッダー名を大文字・小文字の違いで別物として比べるHTTP/2 で小文字で届いたヘッダーを読めない区別しない方法で取り出す
Content-Type : application/json とコロンの前に空白を入れる仕様違反。400 で拒否されることがある名前の直後にコロンを書く
Authorization や Cookie が入った -v の出力を共有するトークンやセッションが漏れる値を伏せてから貼る

よくある質問

自分で作ったヘッダーに「X-」を付けるべきですか?

MDN によると、独自のヘッダーに「X-」を付ける慣習は、2012 年の RFC 6648 で非推奨になりました(標準になったときに名前を変えられず困るため)。X-Content-Type-Options のように、昔からの名前がそのまま使われているものもあります。

ヘッダーと本文は、どうやって区切られていますか?

空行(\r\n\r\n)で区切られます。本文がどこで終わるかは Content-Length などで分かります。RFC 9110 5.5 は、ヘッダーの値に CR・LF(改行)や NUL が入ったものを「無効で危険」としています。改行を入れられると、その後ろを別のヘッダーとして読ませることができてしまうため、利用者の入力をヘッダーの値に使うときは、改行を含むものを拒否します。

まとめ

HTTP メッセージは、1 行目・ヘッダー・空行・本文の形です。ヘッダー名は大文字・小文字を区別しません。トラブルのときは、curl.exe -v や開発者ツールで、送った Content-Type・Authorization と、返ってきた Content-Type の charset・Location・ステータスコードを順に確かめましょう。

関連する記事・ツール

ABOUT ME
hr
hr
エンジニアとして働いている hr です。仕事や資格勉強で「こんなツールがあれば」と感じたものを、無料Webツールと解説記事にして発信しています。
記事URLをコピーしました