API（Application Programming Interface）とは、特定の機能を外部に提供するための「接続口」です。現代のシステム開発は、巨大なシステムを単体で構築・運用する時代から、小～中規模のシステム・アプリケーションを連携させる時代に移行しています。こうした流れの中でAPIが重宝されるようになり、その開発に力を入れる企業が増えています。
APIとはエンジニア同士の会話やIT関連記事の中で、またウェブ関連の求人で登場する言葉のひとつです。とはいえ「APIを漠然と理解しているけれど、あらためて意味や開発メリットを聞かれると答えられない」という方もいるのではないでしょうか。そこで、API開発のメリットや種類、活用事例などを解説します。
APIとは？
APIは、ソフトウェアやアプリケーションの機能を外部に提供する「口」を指す言葉です。
アプリケーションは通常、異なるシステムに存在する他のアプリケーションが持つ機能を利用できません。しかし、APIを使って他のアプリケーションに接続することで、あたかも同じシステム内にあるかのようにその機能を利用できるようになります。
近年はAPIといえば「WebAPI」を指すことが増えました。しかし、元々はオフライン環境で活用されていた技術です。
API開発の目的
API開発が注目されている理由は以下です。
-
・サービス利用者の利便性が向上する・開発フェーズにおいて生産性・効率性が向上する
・自社サービスの技術資産価値を高められる
企業によってAPI開発の目的は異なりますが、提供するサービスやシステムによってはAPIを使うことで効率的な活動が可能になります。後述するメリットとあわせて考えると、よりAPI開発の目的が理解できるでしょう。
APIの具体例
APIはさまざまなシステムやソフトウェアで見かけます。ここでは、実際に利用されているAPIの活用例をいくつかご紹介します。
Twitter API
Twitterでもツイート機能、ハッシュタグ、Twitter内検索などの機能が利用できるAPIを公開しています。主にWebサイト上でリアルタイムの呟きを表示させたり、特定のキーワードが含まれるツイートや企業アカウントに対して向けられたツイートだけを抽出し表示する使い方が多いです。
企業のサイトだけでなく個人で作成されたサイト・ブログでも活用されています。
Amazon MWS
Amazon MWSはAmazonの出品者アカウント向けのAPIです。Amazonでの販売効率を高めるために開発され、出品者は出品や注文、支払い、レポートなどをプログラムでデータ交換できます。注文情報の確認や情報更新が楽になり、Amazonマーケットプレイスが使いやすくなるメリットがあります。
AmazonではAmazon MWSの他にProduct Advertising API（PA-API）も公開しています。こちらはWebサイトやブログなどで、Amazonアソシエイトを経由したアフィリエイト広告の売上データを管理する目的で使われるものです。
Google Calendar API
Googleが提供しているGoogle Calendarに搭載されているAPIです。
主にWebサイトとGoogleカレンダーを結びつけるAPIで、例えば飲食店などの実店舗サイトで店休日や営業時間の変更を知らせる際に活用されます。営業カレンダーは自作すると相当な工数がかかりますが、Google Calendar APIを利用するとGoogleカレンダーに入力するだけでサイト上に表示可能です。
すでにGoogleが一般向けに提供している機能であるためバグも少なく、高品質なカレンダーを自社サイトやアプリで利用できます。
freee API
会計ソフトであるfreee会計ではアカウントを所持するユーザー向けにAPIを公開しています。freeeアプリで解決できない複雑な操作が可能になり、サービスをより効率的に活用できるでしょう。freeeAPIでは、「事業者情報を取得する」「取引を作成」「取得する勘定科目を作成・更新・取得する」などの操作ができます。
YouTube Data API
動画共有サービスであるYouTube。YouTube上の動画をWebサイトやアプリと結びつけるAPIです。
Webサイトを閲覧していると、YouTubeの動画が埋め込まれていて閲覧できた経験がある方もいるのではないでしょうか。これはYouTubeAPIの埋め込みプレーヤーが使用されており、YouTubeに直接アクセスしなくてもサイトやアプリ内で動画が再生できます。
動画の再生だけでなく、ユーザーがWebサイトからクリックすればYouTubeチャンネルを購読する・競合調査のデータ収集をするなども可能です。
APIを開発するメリット
APIを開発するとどんなメリットがあるのか、まずは開発側の視点から考えてみましょう。以下の3点にまとめました。
プロジェクト内の開発効率向上
APIでさまざまな工程を自動化できれば、開発効率も向上します。例えば電話によって状況確認が必要だったことがAPIを使って自動的にデータを入手できたとします。API開発によって割く人員やコストを削減でき、開発効率を高められるでしょう。
こうしたAPI開発のメリットは、バックオフィス系で重宝されます。
自社が持つ技術資産の価値を上げる
APIの開発と公開は「アプリケーションが持つ価値を外部に広める」効果があります。既存の自社開発アプリケーションにAPIを設けることで、社内外の再利用性が向上します。さらに仕様を標準化して公開すれば、より多くの企業・顧客に利用されるようになるでしょう。
また、より多くの人々に利用してもらうことで良質なフィードバックを得ることができ、改良や改修を経てアプリケーションの価値がさらに上がります。これら一連のプロセスが、自社の技術資産の評価につながっていくわけです。
UXや顧客満足度の向上
UX（ユーザーエクスペリエンス）とは、製品やサービスから得られるユーザーの体験を指します。サービス提供者にとってユーザーが思うように「楽しい」「心地よい」といった体験を重ねられると、顧客満足度にも影響するでしょう。
APIは自社サービスをより周知し使いやすくするために開発されるので、UXや顧客満足度の向上につながります。APIを公開することで「使いやすい」と思ってもらえるのも、開発するメリットの一つです。
APIを利用するメリット
APIを連携するメリットを利用者側の視点で解説します。利用するメリットは主に以下4点が挙げられます。
開発効率の向上と低コスト開発
APIを上手く活用することで、複雑な機能を持った仕組みを素早く・低コストに開発することが出来ます。例えば、機能Aを持ったシステムをAPIなしで構築する場合、アプリケーションを新規に開発しなくてはなりません。一方、APIを活用すれば、機能Aを持った外部アプリケーションとの連携により、求める仕組みが実現できるようになります。また、機能Aは外部アプリケーションから提供されるため、不具合修正やチューニングの手間もほとんど必要ありません。
セキュリティコントロールが容易になる
ログイン処理などをAPI連携で行えば、連携先の認証システムによるセキュリティチェックを利用できるため、セキュリティコントロールが容易になります。近年よく使われるSNS連携によるログイン認証などが良い例です。
高セキュリティ・高評価といった信頼度の高いAPIを利用することで、自社サービスのセキュリティをより堅牢にすることもできます。とはいえ使い方には注意が必要なので、あくまでAPIの利用例の一つとして捉えておくとよいでしょう。
データの共有ができる
例えばAmazon MWSはデータの共有を目的としたAPIです。ネットショッピング関連のAPIでは、データを共有することでアフィリエイト分析に役立てたり、販売効率を高めたりできます。APIを利用することでデータ共有の工程を少なくし、生産性アップも目指せるのがメリットの一つです。
最新情報を取得できる
APIを利用すると各サービスの最新情報を自動的に取得・利用できます。例えば自社サイトでAPI提供者の商品を販売しているとしましょう。販売価格・商品仕様・在庫数の変更も自動で反映でき、情報確認や更新などの手間が省けます。
API開発の基礎知識
以前のAPIは設計思想が共通化されていませんでした。しかし近年はAPI活用の広まりから共通の設計思想が生まれています。そのひとつが「REST」です。
RESTとは「REpresentational State Transfer」の略称で、広く普及したWeb上の資産をそのまま活用し、小さな手間でさまざまなWebサービスへアクセスできる仕組みを指します。このRESTに従って作られたWeb APIは「RESTful API」と呼ばれ、近年のAPIのスタンダードになりつつあります。したがって、RESTを知ることはWeb APIの設計原則を知ることにつながるわけです。
まずはRESTの設計原則を解説し、API開発手順の概要をご紹介します。
RESTの設計原則
RESTは「分散システム上で複数のアプリケーションを連携させることに適した設計手法」を集めた考え方です。その原則は、以下4つに要約できます。
-
・アドレス可能性があること…アドレスが指定できるURIが公開されていること・統一インターフェースであること…情報の取得（GET）、更新（PUS）、作成（POST）、削除（DELETE）といった操作がHTTPメソッドを利用して行われること
・ステートレスであること…すべてのHTTPリクエストが分離しており、状態管理が行われないこと
・接続性を持つこと…ある情報に他の情報へのリンクを含めることができ、その情報へ接続できること
API開発手順の概要
実際のAPI開発では、まず「どのユーザーに対して何を提供するか」を念頭に置いてAPI設計を開始します。そのうえで、以下3つのステップに沿って開発が進められます。
API仕様の設計
APIの種別（シンプルで単機能なAPIか、システム統合の一部か、バックエンドの一部かなど）を特定します。また、データフロー（両方向通信、一方向通信）やセキュリティ要件も確定します。
API開発
プログラミングによってAPIプログラムを開発します。
検証とエラー処理
開発したAPIプログラムを設置し、動作検証とエラー処理のチェックを行います。
APIの利用方法
APIを利用するには基本的な操作が必要です。利用方法を手順ごとに解説します。
APIを公開しているサービスに登録する
まずはAPIを提供するサービスに登録します。Amazon MWSであればAmazonの出品者アカウントを、freee APIを利用する場合はfreeeアカウントが必要です。TwitterやFacebook、InstagramといったSNSのAPIを利用する場合もアカウント登録をしておきましょう。
APIを公開しているサービスに自身のアカウントを登録することを、API連携と呼びます。自分のアプリを登録し、使うための準備を整えておきましょう。
APIキーとシークレットを取得
次にAPIキーとシークレットを管理画面上で取得します。この二つはAPIを利用する場合に欠かせないもので、第三者に漏洩しないように管理する必要があります。シークレットとはAPIキーのパスワードとなるもので、APIキーだけでなくシークレットも取得しないと利用できません。
APIキーとは
APIキーとはAPIサービスの提供事業者、サービス発信元が独自に発行する認証情報であり、提供側が利用者の識別（どのアプリケーションで接続されたのか）や利用者の承認（利用者がサービスを利用する権限を持っているか）を判断するためにAPIキーを使います。またAPIキーは固定ではなくランダムに生成される文字列です。予測ができないことから権限を持たない他の利用者からのアクセスを防ぎ、セキュリティを高める効果が期待できます。
取得したAPIキーとシークレットを自アプリに登録
取得もしくは作成したAPIキーとシークレットをアプリに登録しましょう。アプリによって登録方法は異なりますが、サービスにサインインし管理画面を表示すると「アプリの登録」「新規登録」などからアプリを登録できます。
登録完了後にはアプリが登録されているかを確認しましょう。
API使用部分を実装
設定が完了したら、APIを実際に使ってみます。APIドキュメントなどリファレンスを参考にして実装可能です。
APIドキュメントとは、端的にいうと「説明書」です。APIにどんな仕様があり、どんなことができるかが記載されています。ほとんどのAPIでサンプルコードなどを公開しているため、その通りに手順を進めれば基本的なAPIの実装ができます。
API連携の注意点
APIを利用すると各段に便利になり、また開発業務も効率化できます。しかしAPI連携には注意することもいくつかあるため、一つずつチェックしていきましょう。
API開発側はインターフェースを容易に変更できない
まずはAPIを開発する際のデメリットです。開発側はインターフェースを簡単に変更できないため、信頼度の高いインターフェースを選び構築する必要があります。操作が難しく挙動を予測したり読み解きながら開発しなくてはならないインターフェースは、その分コストがかかります。
API提供が停止される可能性がある
APIは必ずしも永続してサービス提供されるものではありません。APIを利用すると少なからず提供元に依存することになり、API提供が停止した場合や仕様変更された際に緊急的な対応が必要になります。
API提供元のサーバーにトラブルが生じると、自社サービスにも悪影響が及ぶのは注意すべき点でしょう。万が一のトラブルやサービス停止の場合に、BCP（事業継続計画）を策定しておくことも大切です。
連携失敗時の処理を考える必要がある
例えAPIの利用が停止されなくても、提供元のサーバーダウンやサーバー障害が発生したりすると連携が失敗することもあります。他社のAPIを利用し自社開発を進めていると、自社サービスの可用性低下に直結してしまうでしょう。
この場合も運用前にBCPを策定しておくことをおすすめします。APIは便利ですが、失敗しないわけではないため注意が必要です。
課金が必要になることも
APIの中には無償で利用できるものもあれば、利用するサービスや期間に応じて費用がかかるものもあります。利便性のみを追求しAPI連携をしても、課金が必要なため利益を損なう可能性があります。コストがかかる場合は、見合ったメリットが受けられるかどうかはよく確認しておきましょう。
課金額はAPIやAPI提供者によってさまざまです。連携前にチェックしておくとよいでしょう。
APIの種類と活用事例
APIの種類と活用事例を紹介します。ここでは、近年特に利用頻度が高いWeb APIを中心に見ていきましょう。
利用形態による分類
まず利用形態による分類では、以下4種類のAPIが挙げられます。
Open API
「パブリックAPI」とも呼ばれる外部公開型のAPIです。接続仕様が広く公開されており、第三者が比較的自由に接続できるようになっています。例えば銀行業界では、自社が保有する顧客情報をOpen APIとして公開し、金融サービスを行いたい企業に提供している事例があります。また、配車サービスの「Uber」も配車リクエストボタンをOpen APIとして公開しています。このAPIを使うことで、ホテルやレストランが自社アプリに配車リクエスト機能を付与できるようになっています。
パートナーAPI
特定のビジネスパートナー・顧客にのみ公開されたAPIです。Open APIよりも制限が厳しく、特定の条件を満たした相手だけがAPIの機能を活用できます。活用事例としては、大手ECサイトにおけるセラー会員向けのAPI情報提供サービスなどがあります。
内部API
特定の組織内（閉じたネットワーク内）のみで公開されるAPIです。プライベートAPIとも呼ばれます。企業内における部門間のデータ連携や情報共有ツール、システム連携などに用いられることが多いでしょう。
複合API
複数のシステムに対して連携・結合を行うAPIです。分散したシステムに存在する複数のアプリケーションを連携先として設定できます。マイクロサービス同士をつないで、ひとつの大きなソリューションを構築する場合などに使用されます。
使用するプロトコルによる分類
Web APIは、使用するプロトコルによる分類も可能です。
REST
RESTでは一意なURIで情報資源を表現し、HTTP技術での操作を行います。最近では、REST APIを利用してサーバーとネットワーク機器に設定変更依頼をかけ、ITインフラの運用を自動化するといった事例が増えています。
RPC（Remote Procedure Call）
RPCは、あるシステムから別のシステムの関数を呼び出す手法です。Web APIとしての歴史は最も古く、動作がシンプルであることから現在も活用されています。Webブラウザやモバイルアプリのサーバー間通信などに使われることが多いでしょう。
SOAP（Simple Object Access Protocol）
XMLを使い、異なるシステム同士の通信を行う手法です。メッセージ送受信型のAPIとも呼ばれます。金融や医療など、レガシーシステム上で使われることが多いでしょう。
API開発に関するFAQ
API開発に関するよく見られる疑問とその回答をまとめました。
Q1.API開発の目的は何ですか？
API開発には、サービス利用者の利便性が向上する、開発フェーズにおいて生産性・効率性が向上するなどの目的があります。自社サービスのAPIを開発するのは「自社サービスのベネフィットを高めるため」「宣伝目的のため」といった目的を持つ企業は多いです。とはいえ、各社でAPI開発の目的は異なり、API開発に携わるためには目的を明確に知っておくとよいでしょう。
Q2.APIはなぜ必要なのでしょうか？
IT関連では異なるアプリやソフトウェアをつなぐ必要があり、システム同士をつなぎインターフェースとして利用するためにAPIが活用されます。APIを利用して開発したアプリと外部でやりとりするために、APIが必要です。
また自社サービスの技術資産価値を高めるためにも必要で、多くのメリットを享受するために開発されています。
Q3.API連携のメリットは何ですか？
API連携・APIを利用するメリットには、APIによって開発の効率化が測れる、データを素早く共有できる、最新情報の取得が容易になるなどが挙げられます。
まとめ
近年APIが重宝されるようになってきた背景の一つとして、巨大なシステムを単体で構築・運用する時代から、小～中規模のシステム・アプリケーションを連携させる時代への移行が進んでいる点が挙げられます。ITエンジニアとしてAPI開発の知識とスキルを身に着けることは、活躍の場を広げることにもつながるでしょう。
ITエンジニアの転職ならレバテックキャリア
レバテックキャリアはIT・Web業界のエンジニア職を専門とする転職エージェントです。最新の技術情報や業界動向に精通しており、現状は転職のご意思がない場合でも、ご相談いただければ客観的な市場価値や市場動向をお伝えし、あなたの「選択肢」を広げるお手伝いをいたします。
「将来に向けた漠然とした不安がある」「特定のエンジニア職に興味がある」など、ご自身のキャリアに何らかの悩みを抱えている方は、ぜひ無料のオンライン個別相談会にお申し込みください。業界知識が豊富なキャリアアドバイザーが、一対一でさまざまなご質問に対応させていただきます。
「個別相談会」に申し込む
転職支援サービスに申し込む
※転職活動を強制することはございません。
レバテックキャリアのサービスについて
