【入門編】 HTTPヘッダーAcceptの役割 – Web APIアーキテクチャ・データ連携実践ガイド

こんにちは！ネットワークの深淵を愛するインフラエンジニアです。

今日は、Web APIの世界で非常に重要でありながら、実は初心者がふと足元をすくわれやすい「HTTPヘッダー」の深淵、その中でも特に大事な Accept ヘッダーについて紐解いていこうと思います。

API開発を始めたばかりだと、「URLさえ正しければデータは返ってくるでしょ？」と思いがちですよね。でも、ネットワークの世界はそんなに甘くありません。今日は、なぜ Accept ヘッダーが必要なのか、郵便配達の仕組みに例えて優しく解説していきます。

—

1. 郵便配達で例える「Accept」の役割

皆さんが誰かに手紙を送る場面を想像してください。あなたは相手に「資料を送ってほしい」と頼みます。でも、相手はデジタルデータで持っているかもしれませんし、紙の書類で持っているかもしれません。

もしあなたが「とにかく何でもいいから送って！」と頼んだら、相手はどの形式で送ればいいか迷いますよね。そこで、私たちはこう伝えます。

「PDFファイル形式で送ってね！」

これが、Web APIにおける Accept ヘッダーの正体です。

クライアント（ブラウザやあなたの書いたプログラム）がサーバーに対して、「私はこういう形式のデータなら理解できるよ！だからこの形式で送って！」とあらかじめ意思表示をするための「希望リスト」のようなものなのです。

—

2. なぜ Accept が必要なのか？

インターネット上のサーバーは、とても気が利く存在です。同じURL（例えば /api/users/1 ）に対するリクエストでも、相手が誰かによって出す料理を変えることができます。

ブラウザからなら、人間が見やすい text/html (HTML) を返そう。
プログラムからのリクエストなら、機械が処理しやすい application/json (JSON) を返そう。

サーバーがこの「判断」をするために必要なのが、クライアントから送られてくる Accept ヘッダーというわけです。これがないと、サーバーは「とりあえず一番無難なやつを送るか…」と、あなたの期待しない形式のデータを送りつけてしまうかもしれません。

—

3. 実際に触ってみよう：curlコマンドでの実験

言葉だけでは実感が湧きませんよね。ここで、エンジニアの必需品 curl コマンドを使って、実際にサーバーに「お願い」をしてみましょう。

まずは、Accept ヘッダーを指定してリクエストを送る例です。

# -H はヘッダーを指定するオプションです
# 「私はJSON形式を受け取れるよ！」とサーバーに伝えています
curl -H "Accept: application/json" https://api.example.com/items/1

もし、サーバーが「CSV形式」もサポートしているなら、以下のように変えるだけで、同じURLからCSVデータを引き出すことも可能です。

# CSV形式を要求する場合
curl -H "Accept: text/csv" https://api.example.com/items/1

このように、Accept ヘッダーを書き換えるだけで、同じ入口（URL）から異なる形式のデータを受け取れる。これがREST APIの美しい設計の一つなんです。

—

4. サーバー側の受け入れ準備：Python (Flask) の例

では、受け取る側のサーバーはどうしているのでしょうか。Pythonの軽量フレームワーク Flask を例に見てみましょう。

from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route('/data')
def get_data():
    # クライアントが何を要求しているかを確認
    accept_header = request.headers.get('Accept')
    
    # もしJSONを要求されたら
    if 'application/json' in accept_header:
        return jsonify({"message": "これはJSONデータです"})
    
    # もしテキストを要求されたら
    elif 'text/plain' in accept_header:
        return "これはテキストデータです"
    
    # どれにも当てはまらない場合はエラー（406 Not Acceptable）を返すのが礼儀です
    return "形式がサポートされていません", 406

このように、サーバー側は Accept ヘッダーの中身を見て、条件分岐（ハンドリング）を行っています。この「クライアントの希望を尊重し、最適な形式で提供する」という振る舞いこそが、Web APIを美しく、そして堅牢にする秘訣なのです。

—

5. まとめ：ネットワークは「対話」である

いかがでしたか？ Accept ヘッダーは、単なる文字列の羅列ではなく、クライアントとサーバーの間で行われる「意思疎通の約束事」であることがお分かりいただけたかと思います。

クライアントは「私はこれが得意だよ」と伝え、
サーバーは「じゃあそれを用意するよ」と応える。

このシンプルな対話の積み重ねが、インターネットという巨大なネットワークを支えています。

これから皆さんがAPIを設計したり、叩いたりするときは、ぜひこの Accept ヘッダーの存在を思い出してください。URLを叩く前に、少しだけ「相手に何を送ってほしいか」を意識するだけで、ネットワークの挙動がぐっと身近に感じられるはずです。

それでは、また次回のネットワーク深淵ツアーでお会いしましょう！Happy Hacking!