【入門編】 ETagヘッダーによる条件付きリクエスト(If-None-Match)の仕組み – Web APIアーキテクチャ・データ連携実践ガイド

「まだ同じデータ送ってるの？」通信の無駄を極限まで削るETagの魔法

エンジニアの皆さん、こんにちは。日夜ネットワークの海を渡るパケットたちと対話しているインフラアーキテクトです。

Web APIを作っていると、「リソースを更新していないのに、毎回重たいデータを全部送り直すのって、ちょっと無駄じゃない？」と感じること、ありますよね。サーバーの帯域幅も、クライアントの通信量も、何よりサーバーのCPUリソースも、もっと賢く使いたい。

そこで登場するのが、HTTPの渋い職人技、ETagです。今日は、この「条件付きリクエスト」という仕組みを、身近な例えを交えて紐解いていきましょう。

—

ETagって、一体なにもの？

ETag（Entity Tag）をひと言で言えば、「リソースの指紋」です。

想像してみてください。あなたは巨大なカタログ（APIのレスポンス）を、遠く離れた友人に送ろうとしています。カタログの内容はたまにしか変わりません。

毎回、何百ページもあるカタログを丸ごと郵送するのは大変ですよね？そこで、あなたはカタログに「この版数は『ver.2023-10-01-A』だよ」というタグを付けておきます。

次回、友人が「カタログちょうだい」と言ってきたとき、もし彼が「ver.2023-10-01-Aなら持ってるよ」と伝えてくれたらどうでしょう？あなたは「ああ、じゃあ内容は変わってないから送らなくていいね。同じだよ！」と短い手紙を返すだけで済みます。これが ETag と 304 Not Modified の仕組みです。

仕組みの裏側： If-None-Match が握る鍵

このやり取りをWebの世界で行うために使われるのが、If-None-Match というヘッダーです。

1. 初回リクエスト: クライアントがデータを要求。サーバーはデータと一緒に ETag: "abc-123" という「指紋」を返します。クライアントはこの指紋を大切に保管します。
2. 2回目以降のリクエスト: クライアントは保管しておいた指紋を If-None-Match: "abc-123" というヘッダーに乗せてサーバーに送ります。
3. サーバーの判断: サーバーは現在のデータから生成した指紋と、送られてきた指紋を照合します。

一致した場合: 「おっ、変わってないな」と判断し、データ本体は送らず 304 Not Modified という「変更なし」の合図だけを返します。
不一致の場合: 「最新版はこれだよ」と、新しいデータと新しい指紋をセットで返します。

これだけで、ネットワークを流れるデータ量が劇的に減るのです。

実装のヒント：指紋（ETag）はどう作る？

ETag の生成には、一般的にデータの「ハッシュ値」を使います。Pythonで簡単に書くとこんなイメージです。

import hashlib

def generate_etag(data):
    # データをハッシュ化して指紋を作成
    # 実際には更新日時やサイズを組み合わせることも多いです
    return hashlib.md5(data.encode('utf-8')).hexdigest()

# サーバー側での擬似的なレスポンス生成
data = "{\"user\": \"Taro\", \"status\": \"active\"}"
etag = generate_etag(data)

print(f"ETag: {etag}") # 指紋を出力

サーバーの運用現場では、ファイルなら「最終更新日時＋ファイルサイズ」を組み合わせたり、データベースのレコードなら「更新日時（updated_at）」をハッシュ化して使うのが定石ですね。

現場で役立つ確認コマンド

開発中、実際にこの仕組みが動いているかを確認するには、curl コマンドが一番です。-i オプションをつけるとヘッダーが見えます。

# まずは初回リクエスト（指紋をゲット！）
curl -i https://api.example.com/data

# 次に、ゲットした指紋を使って条件付きリクエスト
curl -i -H 'If-None-Match: "ここにさっきの指紋を入れる"' https://api.example.com/data

もしサーバーが正しく設定されていれば、レスポンスの先頭に HTTP/1.1 304 Not Modified が表示されるはずです。データ本体は空っぽで、通信量はわずか数バイト。これぞプロの最適化です。

まとめ：一歩ずつ、効率的なAPIへ

ETag を活用することで、無駄なデータ転送をなくし、APIをより高速でサステナブルなものに変えることができます。

ETagはリソースの「指紋」
If-None-Matchで「これ持ってる？」とサーバーに問いかける
304 Not Modifiedなら、データ転送はゼロ！

最初は少し難しく感じるかもしれませんが、この「サーバーとクライアントの賢いやり取り」を一つずつ実装していくことで、皆さんの作るシステムはより強靭で美しいものになっていきます。

ネットワークの世界に完璧な答えはありません。でも、こうした小さな工夫の積み重ねが、やがて大きなパフォーマンスの差となって現れるんです。ぜひ、皆さんの開発するAPIにも、この「指紋」を取り入れてみてくださいね。

それでは、また次回の深淵でお会いしましょう！