APIの定番！「Web API」とは？？
皆さまこんにちは。2020年に新卒として株式会社コンピュータマネジメントに入社し、Webマーケティングを担当している入社4年目のMです。
前回記事では、API（Application Programming Interface）についてご紹介しました。
「API」とは、異なる2つのソフトウェアやプログラム同士を「繋げる」ための窓口であり、外部サービスが持つ機能をわざわざ1から開発しなくても、自社のWebサイトやアプリケーションへ簡単に組み込めるものでしたね。
そのAPIにもいくつか種類があり、現在最も広く使われているのが「Web API」です。今では、APIと言うとほとんどの場合「Web API」を指します。
そこで今回は、APIの中でも特に代表的な「Web API」について取り上げてみたいと思います。
Web APIとは？
「Web API」とはWeb上で実現されるAPIの一種で、インターネット上での情報のやり取りに広く使われている「HTTP/HTTPS」の通信方式を利用して異なる2つのアプリケーション同士を繋ぐ仕組みを提供しているものです。
異なる言語間でも通信が可能なため、使用するプログラミング言語の仕様に左右されず、汎用的に利用できることが大きな特徴となっています。
Web APIの種類
Web APIの種類としては、「REST API」と「SOAP API」の2つが代表的なものになります。
REST API
「REST API」（REpresentational State Transfer）とは、「RESTの4原則」という考え方に沿って設計されたAPIのことで、「4原則をすべて満たしたWeb API」という意味を込めて「RESTful API」と呼ばれることもあります。
仕様がシンプルで、開発を簡単かつ効率的に行えることから、現在では様々な分野で広く普及しています。
「RESTの4原則」
・アドレス可能性（Addressability）：
すべての情報が一意なURI（識別子）で表現されるようにする。
┗Webの場合はURI（識別子）として「URL」を与え、URLを打ち込むことで一意のデータが返ってくる状態にする。
・ステートレス性（Stateless）：
過去の情報を保持せず、やり取りは1回ごとに完結する。
・接続性（Connectability）：
やり取りされる情報に、別の情報へのリンク（ハイパーリンク）を含めることができる。
・統一インターフェース（Uniform Interface）：
あらかじめ定義・共有された方法で情報をやり取りする。
┗例1：情報の操作（取得、作成、更新、削除）には、すべてHTTPメソッド「GET」「POST」「PUT」「DELETE」を利用する。
┗例2：やり取りするデータは「JSON形式」で統一する。
※CSVやXMLデータ等も扱えるが、近年は軽量なJSON形式が使われることが多い。
SOAP API
「SOAP」（Simple Object Access Protocol）とは、HTTPの呼び出し（リクエスト）と応答（レスポンス）に「XML」を使ってデータのやりとりを行う通信プロトコル（規約）です。
2000年代前半まではWeb APIとして「SOAP」が主に用いられていましたが、仕様が複雑なことや、扱いにくいXMLのデータ形式に依存していることもあって近年では敬遠され、シンプルで扱いやすい「REST API」のほうが主流となっています。
「SOAP」のSが「Simple」なのに、仕様はシンプルでないのが何とも不思議ですね。
Web APIの代表例
世の中で広く使われているWeb APIの身近な例をご紹介しましょう。
Google Maps API
「Google Maps API」は、自社のWebサイト上にGoogle Mapの機能を埋め込めるWeb APIです。
Webサイトを訪れたユーザーは、わざわざ別ページに移動することなくGoogle MapをWeb上で表示し、目的地周辺の地図を確認したり、地図を拡大・縮小したりすることができます。
Twitter API
「Twitter API」を利用すると、投稿やフォロー、いいね！といったTwitterアプリと同じ操作ができるようになります。
さらに、自動投稿などTwitterにはない機能を付けることもできます。
Amazon API
「Amazon API」は、Amazonの商品情報を取得できるWeb APIで、大きく分けて以下の2種類があります。
・Amazon MWS API：
┗大口出品者向け。納品や出荷などの手続きに関する情報を管理できる。
・Amazon Product Advertising API：
┗アフィリエイター向け。価格や在庫状況、レビューといった商品に関する情報をリアルタイムで参照できる。
YouTube API
「YouTube API」は、YouTube動画を自社のWebサイトに埋め込めるWeb APIで、以下3種類が提供されています。
・YouTube Data API：
┗YouTubeの動画情報が取得できる。
・YouTube Analytics and Reporting API：
┗YouTube動画の解析が行える。
・YouTube Player API：
┗自社のWebサイト上で動画を再生できる。
PayPal API
「PayPal API」は、Webサイトやブログから簡単にオンライン決済が行えるWeb APIです。
別ページに画面遷移することなく、PayPalアカウントの登録情報を呼び出して決済ができるため、ECサイトでも多く用いられています。
天気予報API
「天気予報API」は、アップフロンティア株式会社と一般財団法人日本気象協会が共同事業で運営する、天気予報や様々な指数情報をWebサイト・スマートフォンアプリに組み込めるAPIを提供するサービスです。
直近の2023/8/22には、新たに「1時間ごとの天気予報」もデータ取得できるようになりました。
乗換案内オープンAPI
「乗換案内オープンAPI」は、ジョルダン株式会社が無償提供しているWeb APIです。
自社のWebサイトに、鉄道・空路・高速バスを利用した経路検索機能を追加できます。
まとめ
今回は、サービスやアプリケーションの機能拡張に広く活用されている「Web API」についてご紹介しました。
Webサイト内でのGoogle Map確認やYouTube動画再生など、普段何気なく使っている機能にもWeb APIが活用されていると思うと、ちょっとした親近感が湧いてきますね！
それでは今回はこの辺で。次回のnoteもお楽しみに！
ここまで読んでいただき、ありがとうございました！
この記事が気に入ったらサポートをしてみませんか？