HTTPヘッダーの読み方|リクエストとレスポンスの主なヘッダーをcurlで確かめる
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)。ヘッダーは「名前: 値」の行の集まりで、本文についての説明や、相手へのお願いを伝えます。

- 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> の中身)は次のようになりました。
| URL | Content-Type | Edge での表示 |
|---|---|---|
| /utf8 | text/html; charset=utf-8 | こんにちは、世界 |
| /nocharset | text/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-Options | Content-Type を無視して中身から形式を推測する動作(MIME スニッフィング)を止める。スクリプトやスタイルシートとして読み込むとき、形式が合わなければブロックする | nosniff |
| Content-Security-Policy | そのページが読み込んでよいスクリプトや画像などの出どころを決める。XSS の被害を抑える助けになる | default-src 'self'(同じオリジンからだけ) |
| Strict-Transport-Security | この後はこのホストに HTTPS だけで接続させる(HSTS)。HTTP で送っても無視される | max-age=31536000; includeSubDomains |
| Referrer-Policy | Referer ヘッダーにどこまでの情報を入れるかを決める | 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)に基づくもので、この記事では実際の画面は確認していません。日本語の表示では名前が異なる場合があります。
- Edge で調べたいページを開く
- ページの上で右クリックし、「Inspect」を選ぶ(日本語表示でのメニュー名は確認していません)。開発者ツールが開く
- 開発者ツールの上部にある「Network」タブを選ぶ(見当たらないときは「More tools」ボタンから開く)
- ページを再読み込みする。開発者ツールを開いた後の通信だけが記録される
- 一覧のいちばん上(ふつうはページの HTML)をクリックする
- 右側に表示される「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・ステータスコードを順に確かめましょう。
関連する記事・ツール
- HTTPステータスコード検索:200・301・415 などの意味と原因・対処法を確認
- curlコマンドの使い方|GET・POST・JSON送信・ヘッダーとステータスコードの確認
- HTTPキャッシュの仕組み|Cache-Control・ETag・304を実験で確認
- Cookieとセッションの仕組みとは?ログイン状態が保たれる理由をcurlで確かめる
- CORSとは?エラーの原因と正しい設定を2つのローカルサーバーで確かめる
- PythonでHTTPリクエストを送る方法|urllibとrequestsの使い方と例外処理
- REST APIとは?HTTPメソッド・ステータスコードの意味とcurlでの試し方
- URLの構造とは?スキーム・ホスト・ポート・パス・クエリ・フラグメントを図で解説