SOAP APIとは何ですか？

XMLベースのプロトコルで通信するWebサービスAPI。エンタープライズシステムで広く使われてきた。

SOAP APIのポイントは？

Simple Object Access Protocolの略。リクエスト・レスポンスがXML形式（SOAPエンベロープ）。WSDLで厳密なインターフェース定義。REST APIにシェアを奪われたが、金融・医療系では現役

【そーぷえーぴーあい】

SOAP API とは？

💡 XMLで厳格に定義された「お堅い」API通信

📌 このページのポイント

Simple Object Access Protocolの略
リクエスト・レスポンスがXML形式（SOAPエンベロープ）
WSDLで厳密なインターフェース定義
REST APIにシェアを奪われたが、金融・医療系では現役

SOAP APIのメッセージ構造と通信の流れ

ひよこ

REST APIと何が違うの？

ペンギン先生

RESTはHTTPメソッド（GET/POST/PUT/DELETE）でリソースを操作するシンプルなスタイル。SOAPはXMLのメッセージ構造で「操作」を定義する厳密なプロトコル。RESTはJSON+HTTPで軽量、SOAPはXML+独自ヘッダーで重厚。RESTは設計の自由度が高い、SOAPはWSDLで厳密に型定義されるという違いだよ

ひよこ

SOAPの強みは？

ペンギン先生

①WS-Securityによるメッセージレベルのセキュリティ（HTTPSだけでなくXML自体を暗号化・署名）、②WS-ReliableMessagingによるメッセージ保証、③WS-AtomicTransactionによる分散トランザクション、④WSDLによる厳密なインターフェース定義とコード自動生成。信頼性が最重要な金融取引で強いんだよ

ひよこ

なぜRESTに負けたの？

ペンギン先生

SOAPはXMLの冗長さ、WSDLの複雑さ、学習コストの高さが問題。JSONの方がXMLより軽量で読みやすく、ブラウザのJavaScriptと相性が良い。モバイルアプリやSPAの台頭でRESTが主流になった。2010年代以降の新規APIはほぼRESTかGraphQL。SOAPは既存システムの保守で残り続けるよ

ひよこ

今でもSOAPを使うケースは？

ペンギン先生

①銀行・証券の基幹系API、②医療情報システム（HL7/FHIR以前の連携）、③政府系のレガシーシステム、④SAP等のERPの連携インターフェース。企業間連携では今でもSOAPが指定されることがある。既存のSOAP APIと連携する必要があるなら、各言語のSOAPクライアントライブラリを使えば比較的簡単に扱えるよ

まとめ：ざっくりこれだけ覚えればOK！

「SOAP API」って出てきたら「XMLベースの厳格なAPI通信プロトコル」と思えればだいたいOK！

📖 おまけ：英語の意味

「Simple Object Access Protocol」＝簡易オブジェクトアクセスプロトコル

💬 Simple（簡易）と名付けられたけど、実際にはかなり複雑。名前負けしているよ

← 用語集にもどる