この記事でわかること
「RESTとSOAPの違い」と「広義のRESTがなぜ現場で広まったか」

背景 🖼️

以下の本で広義のRESTについて述べられていました。

改めて整理したいと思います。

RESTとは 📚

本書でもwikipediaを紹介していました。

まずRESTは以下二つの定義がされています。

FieldingのRESTアーキテクチャスタイルの原則に合わせたWebサービスシステム

RPCスタイルに合わせた簡易なXML（やJSON）＋HTTPインターフェイスを採用したシステム（SOAPは使わない）

ちなみこちらがFieldingさんのRESTについて定義されたものです。

広義のRESTとは2つ目のRPCスタイルに合わせた簡易なXML（やJSON）＋HTTPインターフェイスを採用したシステム（SOAPは使わない）を意味しています。
1つ目のFieldingのRESTの定義にも従いますが全てにおいてその定義に沿うわけではない為と本書には記載されていました。

例えばsearchという動詞をURIに含めることはFieldingのRESTの定義では推奨されていませんが、わかりやすさの為にsearchを使うケースがあります。

「関数呼び出し」をローカルではなく別の環境に接続して代わりに実行すること

この記事ではクライアント側のAPI呼び出しの関数名とそのエンドポイントでイベントハンドラーとなるバックエンド側のDB操作の関数名が同じことを例として挙げていました。

サーバーに対する処理要求や結果をXMLで表現し、それらをHTTPでやりとりすることでRPCを実現することを目指したもの

SOAPは簡単なRPCコールでも以下の理由で情報が多くなりました。

SOAP：標準化や相互運用性は強力だが重い
広義のREST：標準に厳密には従わなくても「HTTP + JSON」でシンプルに始められるので現場で普及

よってSOAPは広義のRESTよりも導入ハードルが高いとわかります。