はじめに
API(Application Programming Interface)は、ソフトウェア同士が「何で頼んで、何で返ってくるか」を定めた決まりごとです。代表的な REST API は HTTP で頼むと主に JSON で返し、gRPC は HTTP/2 の上で Protocol Buffers という形式を使ってやり取りします。本記事では、この違いを Ubuntu 上の curl と grpcurl で実際に通信させ、パケットのバイト列まで分解して確認した結果を紹介します。
API は日常的に使われる言葉ですが、説明を読むだけでは「実際にネットワークを何が流れているのか」をイメージしにくい技術です。本記事ではインフラエンジニアの視点から、コマンドの出力とキャプチャしたパケットをもとに、API の中身を具体的に確認していきます。
- API の基本と、プログラミング言語に依存しない理由
- REST API と gRPC の違い
- curl で REST API に GET / POST / PATCH / DELETE を送る手順
- grpcurl で gRPC の 4 種類の通信方式を呼び出す手順と、検証中につまずいた点
- tcpdump と tshark で見た、HTTP/2・gRPC・Protocol Buffers のバイト列
結論として、REST と gRPC はどちらも「頼み方と返し方の決まりごと」であり、違うのはその「何で」の部分です。今回の検証では、同じ HTTP/2 の上でも、REST は人が読める JSON(application/json)、gRPC はフィールド番号だけを送るバイナリ(application/grpc)で通信していることを確認しました。
この記事の内容は、NETWORK LAB の「API のしくみ(REST と gRPC)」で、パケットの流れを見ながら確かめられます(無料・登録不要)。REST と gRPC を切り替えて、同じ「頼む → 返る」の違いを見比べられます。
▶ ラボを開く(REST) / ▶ gRPC で見る
API とは「何で頼んで、何で返ってくるか」の決まりごと
API は、あるプログラムの機能やデータを、別のプログラムから利用するための決まりごとです。どの宛先に、どの形式で頼めば、どの形式で結果が返ってくるかが決まっていれば、呼び出す側は相手の内部の作りを知らなくても機能を利用できます。
API がプログラミング言語に依存しない理由
Python で作った API も Java で作った API も、外から見ると同じ方法で呼び出せます。これは、やり取りの決まりごとが HTTP や JSON のように、特定の言語に依存しない共通の形式で定められているためです。呼び出す側は、相手がどの言語で作られているかを意識せず、決められた形式で頼み、決められた形式の結果を受け取ります。

「API」と「Web API」の関係
API という言葉は本来広い意味を持ち、OS が提供する機能の呼び出し口や、ライブラリの関数も API に含まれます。一般に「API を叩く」と言う場合は、ネットワーク越しに呼び出す Web API を指すことが多く、本記事で扱う REST API と gRPC も Web API に当たります。
REST API と gRPC の違い
REST API と gRPC の主な違いは次のとおりです。
| 項目 | REST API | gRPC |
|---|---|---|
| 通信の土台 | HTTP(HTTP/1.1・HTTP/2 など) | HTTP/2 |
| データの形式 | 主に JSON(XML なども使用可能) | 主に Protocol Buffers(バイナリ) |
| 頼み方 | URL で表したリソースに、HTTP メソッド(GET / POST / PUT / PATCH / DELETE)で操作する | 「/サービス名/メソッド名」を POST で呼び出す |
| 事前の定義 | なくても呼び出せる(仕様は API ドキュメントで共有) | .proto ファイルでメソッドとデータの型を定義する |
| 通信方式 | 1 回頼んで 1 回返る形が基本 | 1 対 1 に加え、3 種類のストリーミング |
| 主な用途 | 公開 API、Web アプリケーション | サービス間の高速な通信 |
REST API とは
REST(Representational State Transfer)は、URL で表したリソースに対して、HTTP の標準的な操作で読み書きする設計の考え方です。厳密な通信規格ではなく、アーキテクチャのスタイルである点が特徴です。MDN Web Docs でも、一般的な HTTP API が REST の制約をすべて満たしていなくても RESTful API と呼ばれる場合があると説明しています。
参考: MDN Web Docs(REST)
“HTTP APIs in general are sometimes colloquially referred to as RESTful APIs”
(一般的な HTTP API は、口語的に RESTful API と呼ばれることがあります)
https://developer.mozilla.org/docs/Glossary/REST
JSON の使用は REST の条件ではありません。HTTP では、頼む側が Accept ヘッダーで希望する形式を伝え、返す側が Content-Type ヘッダーで実際の形式を示します。現在は JSON が主流ですが、XML などで応答する API もあります。
gRPC とは
gRPC は Google が開発した RPC(Remote Procedure Call)のフレームワークで、別のサーバーにある関数を、手元の関数のように呼び出せるようにする仕組みです。呼び出せるメソッドとデータの型を .proto ファイルで事前に定義し、通信には HTTP/2、データの表現には Protocol Buffers を使います。
gRPC には、1 回頼んで 1 回返る Unary RPC に加えて、サーバーストリーミング、クライアントストリーミング、双方向ストリーミングの 3 種類のストリーミングがあります(gRPC 公式ドキュメント: Core concepts)。
検証環境と使用したツール
検証は 2026 年 11 月 18 日に、インターネットに接続した Ubuntu の VM 上で、CLI だけで実施しました。
| 項目 | 内容 |
|---|---|
| OS | Ubuntu 24.04 LTS(VMware Workstation 上の VM、デスクトップ環境なし) |
| REST の検証 | curl 8.5.0、jq |
| gRPC の検証 | grpcurl v1.9.4(grpc-go 1.83.2) |
| パケットの取得・解析 | tcpdump、tshark |
| REST の接続先 | JSONPlaceholder(jsonplaceholder.typicode.com) |
| gRPC の接続先 | Postman Echo の gRPC サービス(grpc.postman-echo.com) |

JSONPlaceholder は、テスト用の偽データ(fake data)を返す無料の REST API で、登録や API キーなしで利用できます。Postman Echo の gRPC サービスは、API テストツール Postman の公式ドキュメントで gRPC の動作確認用に案内されているサービスです(Postman 公式ドキュメント)。
事前に curl と、JSON を整形して表示する jq をインストールします。
sudo apt update
sudo apt install -y curl jqREST API を curl で検証する
REST API に GET / POST / PATCH / DELETE の 4 種類の操作を送り、どのように頼み、何が返ってくるかを確認しました。
curl -s https://jsonplaceholder.typicode.com/posts/1 | jq{
"userId": 1,
"id": 1,
"title": "sunt aut facere repellat provident occaecati excepturi optio reprehenderit",
"body": "quia et suscipit\nsuscipit recusandae consequuntur expedita et cum\n..."
}URL の /posts/1 で ID 1 の投稿を指定し、その内容が JSON で返ってきました。
curl -v https://jsonplaceholder.typicode.com/posts/1出力のうち、主要な行を抜き出すと次のとおりです。
* ALPN: curl offers h2,http/1.1
* ALPN: server accepted h2
* using HTTP/2
> GET /posts/1 HTTP/2
> Host: jsonplaceholder.typicode.com
< HTTP/2 200
< content-type: application/json; charset=utf-8
< x-ratelimit-limit: 3600000
< x-ratelimit-remaining: 3599999
< cf-cache-status: HIT
< server: cloudflare> の行が送ったリクエスト、< の行が受け取った応答のヘッダーです。読み方は後述します。
curl -s "https://jsonplaceholder.typicode.com/comments?postId=1" | jq '.[0]'
curl -s https://jsonplaceholder.typicode.com/users | jq '.[].name'クエリ文字列 ?postId=1 で投稿 1 へのコメントだけを取り出せました。/users では 10 人分のユーザー情報が配列で返り、jq で名前だけを表示しています。
curl -s -X POST https://jsonplaceholder.typicode.com/posts \
-H "Content-Type: application/json" \
-d '{"title":"test","body":"hello","userId":1}' | jq{
"title": "test",
"body": "hello",
"userId": 1,
"id": 101
}-H で「送る内容は JSON です」と伝え、-d で JSON を送りました。送った内容に "id": 101 が付いて返ってきました。
curl -s -X PATCH https://jsonplaceholder.typicode.com/posts/1 \
-H "Content-Type: application/json" -d '{"title":"changed"}' | jq
curl -s -o /dev/null -w "%{http_code}\n" -X DELETE https://jsonplaceholder.typicode.com/posts/1PATCH では指定した title だけが "changed" に変わり、ほかの項目は元の値のまま返りました。DELETE は本文がなく、ステータスコード 200 だけで結果を返しています。
curl -v の出力からわかること
- ALPN: server accepted h2
-
TLS のハンドシェイクの中で、curl が
h2,http/1.1を提示し、サーバーが HTTP/2(h2)を選びました。後述する gRPC も HTTP/2 の上で動作します。 - content-type: application/json
-
応答の本文が JSON であることを示します。「HTTP で頼んで JSON で返ってくる」様子を、ヘッダーで確認できます。
- server: cloudflare / cf-cache-status: HIT
-
前段の CDN(Cloudflare)が、キャッシュから応答したことを示します。API の応答も、Web ページと同じく CDN を経由する場合があります。
- x-ratelimit-limit / x-ratelimit-remaining
-
呼び出し回数の上限と残りの回数を、ヘッダーで呼び出し側に伝えています。

API の動作を調べるときは、まず curl -v でヘッダーまで表示しておくと、データの形式、HTTP のバージョン、経由している CDN、利用制限などを一度に確認できます。
gRPC を grpcurl で検証する
次に、gRPC を grpcurl で呼び出しました。grpcurl は gRPC 用のコマンドラインツールで、JSON で書いた入力を Protocol Buffers に変換して送り、応答を JSON に戻して表示します(grpcurl の GitHub リポジトリ)。
grpcurl をインストールする
grpcurl は Ubuntu の標準リポジトリに含まれていないため、GitHub のリリースから最新版を取得しました。
VER=$(curl -s https://api.github.com/repos/fullstorydev/grpcurl/releases/latest | jq -r .tag_name | sed 's/^v//')
curl -sLO https://github.com/fullstorydev/grpcurl/releases/download/v${VER}/grpcurl_${VER}_linux_x86_64.tar.gz
tar -xzf grpcurl_${VER}_linux_x86_64.tar.gz grpcurl
sudo mv grpcurl /usr/local/bin/
grpcurl -versionARM の環境では、ファイル名の x86_64 を arm64 に置き換えます。
つまずいた点 1: 443 番ポートなのに TLS ではなかった
まず、サーバーが提供しているサービスの一覧を取得しようとしたところ、エラーになりました。
$ grpcurl grpc.postman-echo.com:443 list
Failed to dial target host "grpc.postman-echo.com:443": tls: first record does not look like a TLS handshakeこのエラーは、TLS で接続しようとしたのに、TLS ではない応答が返ってきたことを示します。-plaintext を付けて TLS を使わずに接続すると、サービスの一覧を取得できました。
$ grpcurl -plaintext grpc.postman-echo.com:443 list
HelloService
grpc.reflection.v1alpha.ServerReflection今回の接続先は、443 番ポートで TLS を使わない HTTP/2(h2c)として応答していました。ポート番号だけでは TLS の有無を判断できない例です。一覧にある grpc.reflection.v1alpha.ServerReflection は、サーバーが提供するサービスの定義を問い合わせるための仕組み(サーバーリフレクション)です。
つまずいた点 2: サービスの定義を読み込めなかった
続けて HelloService のメソッドを一覧しようとしたところ、別のエラーになりました。
$ grpcurl -plaintext grpc.postman-echo.com:443 list HelloService
Failed to list methods for service "HelloService": proto: message field "HelloResponse.reply" using proto3 semantics cannot be requiredサーバーリフレクションで取得したサービスの定義に、proto3 の書式では使えない「required(値を必ず持つ項目)」の指定が含まれていたため、grpcurl が定義を読み込めませんでした。
回避策として、.proto ファイルを手元で作成し、-proto オプションで指定しました。サービス名とメソッド名は gRPC 公式ドキュメント(Core concepts)で例として使われている HelloService に、フィールド名はエラーメッセージの HelloResponse.reply に合わせています。Postman が公開している定義そのものではない点に注意してください。
mkdir -p ~/grpc-test && cd ~/grpc-test
cat > hello.proto <<'EOF'
syntax = "proto3";
service HelloService {
rpc SayHello (HelloRequest) returns (HelloResponse);
rpc LotsOfReplies (HelloRequest) returns (stream HelloResponse);
rpc LotsOfGreetings (stream HelloRequest) returns (HelloResponse);
rpc BidiHello (stream HelloRequest) returns (stream HelloResponse);
}
message HelloRequest {
string greeting = 1;
}
message HelloResponse {
string reply = 1;
}
EOF作成した定義を読み込めることを確認します。
$ grpcurl -import-path . -proto hello.proto list HelloService
HelloService.BidiHello
HelloService.LotsOfGreetings
HelloService.LotsOfReplies
HelloService.SayHellogRPC では、このように「どのメソッドを、どの型で呼び出すか」が事前に決まっていないと、呼び出しを始められません。URL を指定すればひとまず JSON が返ってくる REST API との大きな違いです。
4 種類の通信方式を呼び出す
1 回頼んで 1 回返る SayHello から呼び出しました。
$ grpcurl -plaintext -import-path . -proto hello.proto \
-d '{"greeting":"hello"}' \
grpc.postman-echo.com:443 HelloService/SayHello
{
"reply": "hello hello"
}複数のメッセージを送るメソッドでは、-d に JSON を並べて指定します。
grpcurl -plaintext -import-path . -proto hello.proto \
-d '{"greeting":"a"} {"greeting":"b"} {"greeting":"c"}' \
grpc.postman-echo.com:443 HelloService/LotsOfGreetings4 種類のメソッドの結果は次のとおりです。
| メソッド | 通信方式 | 送ったメッセージ | 返ってきたメッセージ |
|---|---|---|---|
| SayHello | Unary(1 対 1) | hello を 1 回 | hello hello を 1 回 |
| LotsOfReplies | サーバーストリーミング | hello を 1 回 | hello hello を 10 回 |
| LotsOfGreetings | クライアントストリーミング | abc の 3 回 | hello a, b, c を 1 回 |
| BidiHello | 双方向ストリーミング | abc の 3 回 | hello ahello bhello c を 1 回ずつ |
LotsOfGreetings は送り終わってからまとめて 1 回返し、BidiHello は 1 通ごとに返しています。同じ 3 回の送信でも、メソッドの定義によって返し方が変わることを確認できました。
-v を付けると、応答のヘッダーも表示されます。
Resolved method descriptor:
rpc SayHello ( .HelloRequest ) returns ( .HelloResponse );
Response headers received:
content-type: application/grpc+proto
grpc-accept-encoding: identity,deflate,gzip
Response contents:
{
"reply": "hello hello"
}content-type: application/grpc+proto は、中身が Protocol Buffers であることを示します。画面には JSON の形で表示されていますが、これは grpcurl が表示用に変換したもので、実際の通信はバイナリです。
パケットで見る REST と gRPC の違い
最後に、LotsOfReplies を呼び出したときの通信を tcpdump で取得し、tshark で解析しました。
tcpdump で gRPC の通信を取得する
sudo tcpdump -i any -nn -U -w grpc.pcap 'tcp port 443' &
sleep 2
grpcurl -plaintext -import-path . -proto hello.proto \
-d '{"greeting":"hello"}' \
grpc.postman-echo.com:443 HelloService/LotsOfReplies
sleep 2
sudo pkill -INT tcpdump
wait
tcpdump -nn -r grpc.pcap 'tcp[tcpflags] & tcp-syn != 0'最初に host grpc.postman-echo.com の条件を付けて実行した際は、grpcurl の呼び出しが成功しているにもかかわらず 0 packets でした。ホスト名の条件を外してポート番号だけで絞り込み、-U(パケットごとにファイルへ書き出す)を付けると取得できました。原因の切り分けまでは実施していません。
ens33 Out IP 192.168.46.130.52462 > 34.200.48.217.443: Flags [S], ...
ens33 In IP 34.200.48.217.443 > 192.168.46.130.52462: Flags [S.], ...SYN と SYN/ACK は 1 組だけでした。10 回の応答は、すべて 1 本の TCP 接続の中で届いています。gRPC は 1 本の HTTP/2 の接続の中にストリームを作り、そこへメッセージを流します。
HTTP/2・gRPC・Protocol Buffers の 3 層構造
今回の通信は TLS を使わない h2c のため、tshark で中身を解析できます。-d tcp.port==443,http2 で、443 番ポートの通信を TLS ではなく HTTP/2 として解析するよう指定しています。
sudo apt install -y tshark
tshark -r grpc.pcap -d tcp.port==443,http2 -Y grpc -x | head -40tshark のインストール中に表示される「Should non-superusers be able to capture packets?」は、保存済みのファイルを読むだけであれば No で問題ありません。リクエストを含むパケットの末尾は次のとおりです。
00b0 9b 83 9b d9 ab 00 00 0c 00 01 00 00 00 01 00 00 ................
00c0 00 00 07 0a 05 68 65 6c 6c 6f .....helloオフセット 00b5 の 00 00 0c 以降が、gRPC のリクエスト本体を運ぶ HTTP/2 の DATA フレームです。
| バイト列 | 層 | 意味 |
|---|---|---|
00 00 0c | HTTP/2 | フレームの長さ: 12 byte |
00 | HTTP/2 | フレームの種類: DATA |
01 | HTTP/2 | フラグ: END_STREAM(クライアントの送信の終了) |
00 00 00 01 | HTTP/2 | ストリーム ID: 1 |
00 | gRPC | 圧縮フラグ: 圧縮なし |
00 00 00 07 | gRPC | メッセージの長さ: 7 byte |
0a | Protocol Buffers | フィールド番号 1、ワイヤータイプ LEN(文字列など) |
05 | Protocol Buffers | 値の長さ: 5 byte |
68 65 6c 6c 6f | Protocol Buffers | 値: hello |
HTTP/2 のフレームヘッダーは 9 byte で、長さ・種類・フラグ・ストリーム ID で構成されます(RFC 9113)。その中に入る gRPC のメッセージには、圧縮フラグ 1 byte とメッセージ長 4 byte の計 5 byte が先頭に付きます(gRPC over HTTP2)。ストリーミングで複数のメッセージを送る場合も、この 5 byte の長さ情報でメッセージの区切りがわかります。
Protocol Buffers の先頭の 0a は、フィールド番号とデータの種類(ワイヤータイプ)を組み合わせた値です。
参考: Protocol Buffers 公式ドキュメント(Encoding)
“(field_number << 3) | wire_type”
(フィールド番号を 3 ビット左にずらし、ワイヤータイプと組み合わせる)
https://protobuf.dev/programming-guides/encoding/
フィールド番号 1、ワイヤータイプ 2(LEN)の場合、(1 << 3) | 2 = 0x0a になります。.proto に書いた greeting = 1 の「1」だけが送られ、greeting という名前は通信に含まれません。名前は、送る側と受け取る側がそれぞれ .proto で把握しているためです。


この 3 層の入れ子は、ラボの gRPC の STEP 3 で、下の欄の「中身の比較」を開くと確かめられます。REST に切り替えると、同じ場所が TLS で暗号化されて見えないことも比べられます。
▶ ラボで gRPC の STEP 3 を開く
リクエストヘッダーに見る gRPC の決まりごと
tshark で展開したリクエストヘッダーには、次の項目が含まれていました。いずれも gRPC over HTTP2 の仕様で定められている項目です。
- :method POST
-
データを取得するだけの呼び出しでも、常に POST で送ります。REST API のように GET / PUT / DELETE を使い分けることはありません。
- :path /HelloService/LotsOfReplies
-
「/サービス名/メソッド名」が、そのまま HTTP のパスになります。
- content-type: application/grpc
-
gRPC の通信であることを示します。REST API の
application/jsonに当たる部分です。 - te: trailers
-
本文のあとに送られるトレーラーを受け取れることを示します。gRPC は処理結果のステータスをトレーラーで返し、仕様ではこのヘッダーを非対応のプロキシの検出に使うと説明しています。
また、HTTP/2 はヘッダーを HPACK という方式で圧縮します。キャプチャでは、:method POST が静的テーブルの 3 番を指す 1 byte の 83 で表されていました(RFC 7541)。



gRPC を通す経路では、ロードバランサーやプロキシが HTTP/2 とトレーラーをそのまま中継できるかが確認のポイントになります。HTTP/1.1 にしか対応していない機器を経由すると、gRPC の通信が成立しない場合があります。
JSON と Protocol Buffers のサイズ比較
同じ内容を JSON で表した場合と、実際に送られた Protocol Buffers の大きさを比べました。
| 内容 | JSON で表した場合 | Protocol Buffers(実測) |
|---|---|---|
| リクエスト | {"greeting":"hello"} で 20 byte | 7 byte |
| レスポンス | {"reply":"hello hello"} で 23 byte | 13 byte |
JSON はフィールド名を毎回送るのに対し、Protocol Buffers は番号と長さだけで表すため、同じ内容を少ない byte 数で送れます。一方で、.proto がなければ中身を解釈できないため、人が読んで確かめやすいのは JSON です。用途に応じて使い分けられている理由が、byte 数からも読み取れます。
なお、今回のキャプチャでは、LotsOfReplies の 10 個の応答が 1 つの TCP セグメント(ペイロード 337 byte)にまとまって届いていました。アプリから見た「10 回の応答」と、ネットワーク上のパケット数は一致するとは限りません。
まとめ
API は「何で頼んで、何で返ってくるか」を定めた決まりごとで、REST API と gRPC はその「何で」が異なります。curl と grpcurl で実際に通信させ、パケットを分解すると、REST は JSON を、gRPC は HTTP/2・gRPC・Protocol Buffers の 3 層に包んだバイナリを送っていることを確認できました。
- API は、言語に依存しない形式で頼み方と返し方を定めた決まりごと
- REST API は HTTP で頼み主に JSON で返す設計の考え方で、JSON の使用は条件ではない
- gRPC は .proto で型を事前に定義し、HTTP/2 の上で Protocol Buffers を送る仕組み
- curl -v と grpcurl -v で、application/json と application/grpc の違いを確認可能
- gRPC のストリーミングは、1 本の TCP 接続の中で複数のメッセージをやり取り
- Protocol Buffers は名前ではなくフィールド番号を送るため、JSON より小さい
- 443 番ポートでも TLS とは限らず、gRPC の検証では -plaintext での確認も有効
この記事の検証は、NETWORK LAB の「API のしくみ(REST と gRPC)」で再生しながら振り返れます。NETWORK LAB では、ほかにもネットワークのしくみやトラブルの原因を、パケットの流れを見ながら学べます(無料・登録不要)。NETWORK LAB のラボ一覧はこちら。
以上、最後までお読みいただきありがとうございました。



