HTTP API、REST API、WebSocket APIなどいろいろ種類がありますが、それぞれどう仕様は違う？

質問

HTTP API、REST API、WebSocket APIなどいろいろ種類がありますが、それぞれどう仕様は違う？ ほかにもどんな種類がある？

AWSではじめる クラウド開発入門 【電子書籍】[ 真野智之 ] 価格:3498円 (2026/5/24 13:45時点) 感想(0件)

Web　API：The　Good　Parts [ 水野貴明 ] 価格:2420円 (2026/5/24 13:46時点) 感想(0件)

解答

はい、かなり違います。 ただし重要なのは、 「HTTP API」「REST API」「WebSocket API」は “同じ階層の言葉ではない” という点です。 通信プロトコルの話 設計思想の話 接続方式の話 が混ざっています。 整理すると理解しやすいです。 1. まず「API」とは何か API は本質的には： 「プログラム同士の接続口」 です。 その接続方法にいろいろ種類があります。 2. HTTP API これは何？ HTTP を使って通信する API です。 つまりかなり広い概念。 例えば： GET /users/1POST /orders みたいなもの。 特徴 Webと相性が良い シンプル ブラウザ対応 Firewall通りやすい 現在の主流。 ポイント REST API も通常は HTTP API の一種です。 つまり： HTTP API └ REST API の関係。 3. REST API これは何？ REST は： HTTP API をどう設計するか の「設計思想」です。 通信プロトコルそのものではありません。 REST の代表特徴 リソース指向 例： GET /users/1DELETE /users/1 “ユーザー”というリソースを操作。 HTTPメソッド活用 GET → 取得 POST → 作成 PUT → 更新 DELETE → 削除 Stateless サーバがセッション状態を持たない。 注意 世の中の「REST API」は、 厳密RESTではないことも多い。 4. WebSocket API これは何？ 常時接続型 API です。 HTTP は通常： リクエスト レスポンス 切断 ですが、 WebSocket は： Client ⇄ Server（接続維持） になります。 特徴 双方向通信 リアルタイム 低遅延 用途 チャット オンラインゲーム 株価 通知 ライブ配信 RESTとの違い REST： 都度通信 WebSocket： 接続維持 5. GraphQL かなり重要。 何が違う？ REST： /users/1/orders/1 GraphQL： { user { name orders }} 特徴 クライアントが： 「欲しいデータ形」 を指定できる。 メリット 過剰取得防止 柔軟 デメリット キャッシュ難しい 複雑 6. gRPC 最近かなり増えています。 特徴 HTTP/2利用 Protocol Buffers バイナリ通信 高速 向いているもの マイクロサービス間 内部通信 低レイテンシ RESTとの違い REST： 人間可読JSON gRPC： 高速機械向け 7. SOAP 昔からある。 特徴 XMLベース 厳格 契約重視 よく使われた分野 金融 大企業 SI系 8. SSE（Server-Sent Events） WebSocketより軽量。 特徴 サーバ→クライアントのみ 一方向リアルタイム 用途 通知 ログストリーム 9. MQTT IoT系。 特徴 超軽量 Publish/Subscribe 用途 センサー IoT 低帯域通信 10. API種類を整理すると 種類 本質 HTTP API HTTP利用API全般 REST API HTTP APIの設計思想 WebSocket API 常時接続双方向通信 GraphQL 柔軟データ取得API gRPC 高速RPC SOAP XML契約型API SSE サーバ通知型 MQTT IoT軽量通信 11. 実務ではどう使い分ける？ REST 公開API Webサービス WebSocket リアルタイム gRPC 内部マイクロサービス GraphQL フロント柔軟取得 MQTT IoT 12. 本質的な違い APIの違いは主に： 通信方式 状態管理 データ形式 接続維持 性能 柔軟性 の違いです。 まとめ HTTP API は広い概念 REST は HTTP API の設計思想 WebSocket は常時接続型 gRPC は高速内部通信 GraphQL は柔軟データ取得 つまり、 API の種類とは 「何をどんな通信特性でやりたいか」 によって分かれているんです。

アフィリエイトがしたい人のWordPress講座準備編 副業するならワードプレス【電子書籍】[ 明石 正雄(ビジネス慶) ] 価格:500円 (2025/9/5 19:52時点) 感想(0件)

詳解HTTP/2 （Programmer's SELECTION） [ Barry Pollard ] 価格:4180円 (2025/4/11 17:49時点) 感想(0件)

にほんブログ村

人気ブログランキング