API とは|REST と gRPC の違いをパケットまで分解して検証

  • URLをコピーしました!
目次

はじめに

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 APIgRPC
通信の土台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 だけで実施しました。

項目内容
OSUbuntu 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 jq

REST API を curl で検証する

REST API に GET / POST / PATCH / DELETE の 4 種類の操作を送り、どのように頼み、何が返ってくるかを確認しました。

手順
GET でデータを取得する
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 で名前だけを表示しています。

手順
POST でデータを送る
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 が付いて返ってきました。

手順
PATCH と DELETE を送る
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/1

PATCH では指定した 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 -version

ARM の環境では、ファイル名の 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.SayHello

gRPC では、このように「どのメソッドを、どの型で呼び出すか」が事前に決まっていないと、呼び出しを始められません。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/LotsOfGreetings

4 種類のメソッドの結果は次のとおりです。

メソッド通信方式送ったメッセージ返ってきたメッセージ
SayHelloUnary(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 -40

tshark のインストール中に表示される「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 0cHTTP/2フレームの長さ: 12 byte
00HTTP/2フレームの種類: DATA
01HTTP/2フラグ: END_STREAM(クライアントの送信の終了)
00 00 00 01HTTP/2ストリーム ID: 1
00gRPC圧縮フラグ: 圧縮なし
00 00 00 07gRPCメッセージの長さ: 7 byte
0aProtocol Buffersフィールド番号 1、ワイヤータイプ LEN(文字列など)
05Protocol Buffers値の長さ: 5 byte
68 65 6c 6c 6fProtocol 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 byte7 byte
レスポンス{"reply":"hello hello"} で 23 byte13 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 のラボ一覧はこちら。

以上、最後までお読みいただきありがとうございました。

よかったらシェアしてね!
  • URLをコピーしました!

この記事を書いた人

関西を拠点に活動する、現役インフラエンジニア。経験20年超。

大手通信キャリアにて、中〜大規模インフラ(ネットワーク・サーバ・クラウド・セキュリティ)の設計・構築およびプロジェクトマネジメントに従事。現場で直面した技術課題への対処や、最新の脆弱性情報への実務対応を、一次情報として発信しています。

保有資格
CCIE Lifetime Emeritus(取得から20年以上)/ VCAP-DCA / Azure Solutions Architect Expert

▶ 運営者プロフィール(詳細)

目次