変更履歴
- Rev. 0.7 : 2026年11月18日
- 新規作成
1 本記事概要
1.1 はじめに
天気予報を確認したり、オンライン決済をしたり、メッセージを送信したりするたびに、
アプリは舞台裏で密かに通信をしています。
それを可能にしているのがAPI(アプリケーションプログラミングインターフェース)です。
アプリの用途によって、必要なAPIの種類は異なります。
本記事では、主要なAPIを挙げて行きます。
1.2 主要なAPIの種類
本記事では、下に示す10種類のAPIを取り上げ、それぞれの仕組み、最適な用途、
そして日常生活で既に利用されている場面について紹介します。
各APIには得意分野とトレードオフがあり、開発者は用途に応じて最適な通信手段を選択していることが
肝要です。
- ① REST
-
最も一般的なWeb APIで、シンプルなリクエストとレスポンスの形式を使い、
JSONデータを利用します。 - ② SOAP
-
XMLを使用した厳格で信頼性の高いプロトコルで、速度よりも正確さが求められる銀行や
航空会社などで重宝されています。 - ③ GraphQL
-
Facebookによって開発されたプロトコルで、必要なデータのみを正確に取得できるため、
通信の効率化に貢献します。 - ④ gRPC
-
Googleが公開した高速なプロトコルで、バイナリ形式のデータを用いることで
内部のマイクロサービス間の通信を最適化します。 - ⑤ Webhook
-
イベント発生時にサーバーからデータを即座にプッシュする仕組みで、効率的な通知機能などに
利用されます。 - ⑥ WebSocket
- 双方向のリアルタイム通信を実現し、オンラインゲームやチャットアプリなどで不可欠な 技術です。
- ⑦ Server-Sent Events(SSE)
-
サーバーからの一方向ストリーミングに適しており、AIチャットボットの逐次回答表示などに
使われます。 - ⑧ WebRTC
-
サーバーを介さない直接的なピア・ツー・ピア通信を可能にし、ビデオ通話の遅延を最小限に
抑えます。 - ⑨ MQTT
-
電力や帯域が限られたIoTデバイス向けに設計された軽量なプロトコルで、
スマートホームなどで広く利用されています。 - ⑩ OS API
-
インターネットを介さず、アプリがカメラやファイルなどのローカルハードウェアを安全に
制御するための役割を担っています。
2 REST
REST APIとは、
Webシステムを外部から利用できるようにするためのプログラムの仕組み(API)の一種で、
「REST(レスト)」という設計の考え方(原則)に基づいて作られたものです。
RESTは、「Representational State Transfer」の略です。
2.1 主な仕組み
RESTでは、Webの標準であるHTTPという通信の仕組みをそのまま利用します。
1. リソースをURLで表す
サーバーにあるデータや機能(ユーザー情報や商品データなど)を「リソース」と呼び、
URL(住所のようなもの)で一意に特定します。
例: https://example.com/user-123(「123番のユーザー」というリソース)
2. 操作をHTTPメソッドで表す
「そのデータをどうしたいか」という操作は、HTTPの命令(メソッド)を使って指定します。
3. ステートレスである
サーバー側はクライアント(利用する側のアプリやブラウザ)の「前回の状態」を記憶しません。
1回1回のやり取りが独立しており、必要な情報はすべて1つのリクエストに含めて送信します。
4. 軽量なデータ形式(JSONなど)
やり取りするデータは、
人間にも読みやすく軽量なJSON(JavaScript Object Notation)が使われることが一般的です。
2.2 主な特徴
RESTには、以下に示すような特徴があります。
・ シンプルさと汎用性
URLとHTTPメソッドを組み合わせた直感的な設計で、言語やプラットフォームを問わず
利用可能です。
・ 軽量・高速性
JSON形式などの軽いデータ交換により、モバイルやIoTなど多様なデバイスに適しています。
・ 独立した開発
クライアント側とサーバー側で役割を完全に分離して開発を進められます。
3 SOAP
SOAP
API(Simple Object Access Protocol API)とは、
ネットワーク経由でデータや処理を呼び出すための厳格な通信プロトコル(規約)です。
3.1 主な特徴
SOAPには、以下に示すような特徴があります。
・ データ形式はXMLのみ
送受信するデータはすべてXML形式で記述され、タグ構造によってデータ型や意味を厳密に定義します。
・
WSDL
(Web Services Description Language)
WSDLは、APIが提供するメソッドや引数、戻り値の型情報が記述されたXML形式の仕様書です。
クライアントはこのWSDLを読み込むことで、呼び出し用のコードを自動生成できます。
・ 高いセキュリティと信頼性
WS-Security
などの標準規格に対応しており、金融機関や大規模なエンタープライズシステムで
よく利用されます。
3.2 REST APIとの主な違い
現在主流のREST APIとは設計思想や特徴が異なります。
4 GraphQL
GraphQL APIは、
Meta(旧Facebook)が開発したAPI向けクエリ言語およびサーバーサイド
ランタイムです。
4.1 主な特徴と仕組み
GraphQLには、以下に示すような特徴があります。
・ 必要なデータのみを取得
クライアントが欲しいデータの構造を指定してリクエストできるため、
不要なデータが返ってくる「オーバーフェッチ」や、
データ不足で複数回リクエストする「アンダーフェッチ」を防げます。
・ エンドポイントが1つ
原則として“/graphql”という単一のエンドポイントに対してリクエストを送信します。
・ 主な操作の種類
・ Query(データの取得:RESTのGETに相当)
・ Mutation(データの作成・更新・削除:RESTのPOST/PUT/DELETEに相当)
・ Subscription(WebSocket等を使ったリアルタイム通知)
・ 強力な型システム
スキーマ(定義)によってデータの型が明確に定義されており、
クライアントとサーバー間の契約(バリデーション)がスムーズに行えます。
4.2 REST APIとの違い
REST APIとの違いを以下に示します。
- REST
-
リソースごとに複数のURL(エンドポイント)が存在し、サーバー側が返すデータ構造が固定
されています。 - GraphQL
- 1つのエンドポイントに対し、クライアント側が必要なフィールドを記述して取得します。
4.3 公式または参考サイト
詳細な仕様や公式情報は、 GraphQL 公式サイトをご覧ください。
5 gRPC
gRPCは、
Googleが開発したオープンソースの高性能なRPC(Remote Procedure Call)フレームワークです。
異なる言語や環境で動くプログラム同士を、ローカルの関数を呼び出すかのようにスムーズに接続
できます。
5.1 主な特徴
gRPCには、以下に示すような特徴があります。
・ HTTP/2の採用
1本の通信路で複数のデータを同時に送受信できる「マルチプレクシング(多重化)」や
ヘッダー圧縮により、高速かつ効率的な通信が可能です。
・ Protocol Buffers (Protobuf)の利用
データをテキスト(JSONなど)ではなく、軽量なバイナリ形式でやり取りします。
.protoファイル
でAPIのインターフェースを定義し、各言語のコードを自動生成できます。
・ 4つのメソッドタイプ
- ・ 単項(Unary)
- 1つのリクエストを送り、1つのレスポンスを返す(通常のAPIに近い形)。
- ・ サーバーサイド・ストリーミング
- 1つのリクエストに対し、サーバーから複数のレスポンスを順次返す。
- ・ クライアントサイド・ストリーミング
- クライアントから複数のリクエストを送り、サーバーから1つのレスポンスを返す。
- ・ 双方向ストリーミング
- クライアントとサーバーが同時に複数のメッセージをやり取りするリアルタイム通信。
・ 多言語対応
Go、C++、Java、Python、Rust、C#など幅広いプログラミング言語をサポートしています。
5.2 REST APIとの違い
REST APIとの違いを以下に示します。
- REST
-
「リソース(データ)」の取得・作成・更新・削除を目的とし、
通常はJSON形式をHTTP/1.1などでやり取りします。 - gRPC
-
「メソッド(処理の実行)」の呼び出しを目的とし、
バイナリデータとHTTP/2で高速に通信するため、マイクロサービス間の内部通信などに多く使われます。
5.3 公式または参考サイト
詳細な仕様や公式チュートリアルは、 gRPC公式サイトで確認できます。
6 Webhook
Webhook(ウェブフック)とは、
Webアプリケーションで特定のイベントが発生した際、
外部のサービスやシステムへ自動的にHTTP(主にPOST)リクエストで通知を送る仕組みです。
「リバースAPI」や「プッシュ型API」とも呼ばれます。
6.1 主な特徴と仕組み
Webhookには、以下に示すような特徴があります。
・ イベント駆動(プッシュ型)
「新しい注文が入った」、「フォームが送信された」、「コードがプッシュされた」などのイベントが
起きた瞬間にデータが送られます。
・ ポーリング(定期確認)が不要
従来のように、受信側が「新しいデータはありますか?」と何度も確認しに行く必要がないため、
サーバーの負荷や通信の無駄を減らせます。
・ 主な通信方法
HTTPのPOSTメソッドを使い、データはJSON形式などで送られるのが一般的です。
6.2 通常のAPIとの違い
通常のAPIとの違いを以下に示します。
6.3 主なメリット
Webhookのメリットを以下に示します。
・ リアルタイム性
データの変更やイベント発生とほぼ同時に通知が届くため、タイムラグがない。
・ 省負荷(ポーリング不要)
「何か新しいデータはありますか?」と定期的に確認し続ける必要がなく、
サーバーやネットワークの負荷を減らせる。
・ 自動化の向上
プログラミングやZapier
などの連携ツールを組み合わせることで、
業務フローを簡単に自動化できる。
7 WebSocket
WebSocket
(ウェブソケット)は、
クライアントとサーバーの間でリアルタイムな双方向通信を行うための通信規格です。
IETFによって
RFC 6455
として標準化されています。
7.1 主な特徴と仕組み
WebSocketには、以下に示すような特徴があります。
・ 繋ぎっぱなしの通信路
従来のHTTP通信が「用件を伝えたら接続を切るトランシーバー」だとすれば、
WebSocketは「いつでも自由に会話できる電話回線」のように接続を維持します。
・ HTTPからのアップグレード
通信の開始時(ハンドシェイク)は通常のHTTPリクエストで行われ、
サーバーが承認すると
HTTP/1.1 Upgradeヘッダー
を用いてWebSocketプロトコルに切り替わります。
・ 低オーバーヘッド
接続を確立し続けるため、通信のたびに発生する接続確立のオーバーヘッドが不要になり、
圧倒的な低遅延を実現します。
・ 双方向のデータ送信
HTTPはクライアントからのリクエストがないとサーバー側からデータを送れませんが、
WebSocketではサーバー側からも任意のタイミングでクライアントへデータを送信できます。
7.2 HTTPとの違い
HTTPとの違いを以下に示します。
7.3 良く使われる用途
リアルタイム性が求められる以下のようなアプリケーションで広く使われています。
・ チャットアプリ
・ オンラインゲーム
・ リアルタイムの株価・暗号資産の価格ティッカー
・ ドキュメントの共同編集ツール
・ ブラウザ向けの通知・監視システム
7.4 詳細なAPI仕様や各プログラミング言語での実装方法
詳細なAPI仕様や各プログラミング言語での実装方法は、
MDN Web DocsのWebSocket API
で確認できます。
8 Server-Sent Events(SSE)
Server-Sent Events(SSE)とは、
Webサーバーからブラウザなどのクライアントへ、
HTTP通信を使って「サーバーからデータを持続的かつ一方的にプッシュ送信」するための技術です。
8.1 主な特徴と仕組み
Server-Sent Eventsには、以下に示すような特徴があります。
・ 一方向のリアルタイム通信
サーバーからクライアントへの送信専用です
(クライアントからサーバーへの送信には通常のHTTPリクエスト等を使います)。
・ 標準のHTTPを使用
特別なプロトコルやサーバーを用意せず、
通常のHTTP(Content-Type: text/event-stream)で動作します。
・ 自動再接続機能
通信が途切れた際、ブラウザが自動的に再接続を試みる仕組みが標準で備わっています。
・ 実装がシンプル
JavaScriptのEventSource API
を使って数行で受信処理を実装できます。
8.2 WebSocketとの違い
WebSocketとの違いを以下に示します。
8.3 よく使われる用途
・ 生成AIの回答ストリーミング
ChatGPTなどの回答が、文字ごと・トークンごとにリアルタイムで画面に表示される仕組み
・ ライブ情報・ダッシュボード
株価、スポーツの速報、ニュースフィードなどのリアルタイム更新
・ 進捗状況(プログレスバー)の更新
8.4 公式または参考サイト
詳細な仕様や使い方については、
サーバー送信イベントの使用 – Web API | MDNや
Server Sent Events(SSE)ではじめるリアルタイム通信 – Qiita
をご参照ください。
9 WebRTC
WebRTC(Web Real-Time Communication)は、
専用のプラグインやアプリをインストールすることなく、Webブラウザやモバイルアプリで
直接低遅延のリアルタイム通信(音声通話、ビデオ通話、画面共有、データ転送)を実現する
オープンソースのWeb標準技術です。
Google、Apple、Microsoft、Mozillaなどの主要ベンダーがサポートし、
W3C
およびIETFによって標準化されています。
サーバーを介さない直接的なピア・ツー・ピア通信を可能にし、ビデオ通話の遅延を最小限に抑えます。
9.1 主な特徴
WebRTCには、以下に示すような特徴があります。
9.2 主要なAPIとプロトコル
WebRTCでは、主に以下のAPIやプロトコルを使って通信を構築します。
9.2.1 API
- RTCPeerConnection
- ブラウザ同士のP2P接続の確立、維持、切断を管理する中核API。
- MediaStream
- Webカメラやマイク、画面共有などの映像・音声データを扱うAPI。
- RTCDataChannel
- 音声・映像以外の任意の汎用データをP2Pで送受信するAPI。
9.2.2 プロトコル
- シグナリング(Signaling)
-
接続の最初に相手のIPアドレスやコーデック情報(SDP)を交換するための仲介手順
(WebSocketなどがよく使われます)。 - STUN / TURNサーバー
-
ルーター(NAT)の壁を越えて通信経路を確保したり、
P2Pが難しい場合にデータを中継(リレー)したりするサーバー。 - ICE(Interactive Connectivity Establishment)
-
STUN/TURNなどを利用して、
通信可能な最適なネットワーク経路(IPアドレスとポート)の候補を探し出し、接続を確立します。
9.3 良く使われる用途
・ ビデオ通話・音声チャットアプリ
・ ライブ配信・ライブコマース
・ オンラインゲームのリアルタイム通信
9.4 公式または参考サイト
詳細な仕様や実装方法については、
WebRTC 公式サイトや
MDN Web Docs – WebRTC APIで
確認できます。
10 MQTT
MQTT(Message Queuing Telemetry Transport)は、
IoTやM2M(機械間通信)向けに最適化された軽量なデータ配信プロトコルです。
10.1 基本的な仕組み
・ ブローカー(Broker)
メッセージのやり取りを仲介する中心サーバー
(例: Mosquitto、
EMQXなど)。
・ パブリッシャー(Publisher / 発行者)
データを送る機器(例:温度センサー)。
「topic/room/temperature」といったトピック(宛先のようなタグ)を指定して
ブローカーにデータを送ります。
・ サブスクライバー(Subscriber / 購読者)
データを受け取る機器やアプリ(例:スマホ画面やエアコン制御システム)。
あらかじめ特定のトピックを購読(サブスクライブ)しておくと、
ブローカーから自動でデータが届きます。
10.2 主な特徴
MQTTには、以下に示すような特徴があります。
・ 軽量な設計
最小固定ヘッダーがわずか2バイトと非常に小さく、
メモリや帯域が限られたマイコンや通信環境に向いています。
・ 低帯域・不安定な回線にも強い
ネットワークが細い場所や、よく途切れる環境でも動作するように設計されています。
・ QoS(品質保証)の3段階
QoS 0: 到達保証なし(最大1回)
QoS 1: 最低1回の到達を保証
QoS 2: 重複・欠落のない正確な1回を保証
10.3 主な用途
• スマートホーム(スマート電球、スマートロック、エアコンの遠隔操作)
• 工場やプラントの監視(IoTセンサーによる機械の状態・温度・稼働率の収集)
• コネクテッド・カー(車両データのリアルタイム送信)
• チャットや位置情報トラッキング(スマホアプリのリアルタイム通知)
10.4 公式または参考サイト
詳しい仕様や規格の全体像は、MQTT 公式サイトや WikipediaのMQTT解説で確認できます。
11 OS API
OS API(オペレーティングシステム・API)とは、
アプリケーションソフトが、裏側で動いているOS(WindowsやmacOS、Linux、Androidなど)の機能を
利用するための「窓口(ルール)」のことです。
11.1 OS APIの役割
アプリケーションは、画面にウィンドウを表示したり、ハードディスクにファイルを保存したり、
プリンターを動かしたりする際、直接ハードウェアやシステムを勝手に操作することはできません。
そのため、OSが用意した「OS API」という命令(ルール)を呼び出すことで、
OSを仲介して安全にハードウェアやシステム機能を利用します。
・ OS機能の呼び出し
アプリが画面にウィンドウを表示したり、ファイルを保存・読み込みしたり、
メモリを確保したりする際にOSへ処理を依頼します。
・ システムコールとの関係
アプリからOSの内部機能を呼び出すためのAPIは、特にシステムコールと呼ばれます。
・ ハードウェアの抽象化
アプリは内部の複雑なハードウェア(CPUやディスク、グラフィックボード等)の構造を直接意識せず、
OSが用意したAPI経由で共通の操作ができます。
・ 移植性(可搬性)の保証
同じAPIに対応していれば、
異なるハードウェアやOS環境でも同じように動作するアプリケーションを作ることができます。
11.2 代表的なOS API
- Windows API (Win32 API)
- Windows上で動作するアプリが画面描画やファイル操作などを行うためのAPI
- POSIX (Portable Operating System Interface)
- Unix系やLinuxなどのOSで標準化されたAPI規格
- Android API / iOS API
- スマートフォンのOSが提供するカメラやGPS、センサーなどを動かすためのAPI
11.3 参考サイト
詳細な仕組みや位置づけについては、
IBMのAPI解説記事や
基本情報技術者の過去問解説も参考になります。
以上
本記事の元となっているWordで作成したPDFを
ページ最後に貼り付けました。
少しでも役に立てていただければ、うれしく思います。
このPDFファイルは、自由に配布されてもかまいません。
ただし、再配布の際には、
入手元と著者名は明らかにしてください。
なお、上のPDFファイルの内容、また本文中の記述に、
誤字や脱字、誤った内容の記述など見つかりましたら、
下に示すフォームでご連絡いただければ幸いです。

コメント