「API仕様」の新たな常識
マイクロサービスの次なるステップ? 「API設計ファースト」で変わる開発現場
アプリケーション開発において、マイクロサービスアーキテクチャの次の波と見られているのが「API設計ファースト」という考え方だ。あるアプリケーションベンダーが実践する開発手法や使用ツールを紹介する。
アプリケーション開発において、「マイクロサービスアーキテクチャ」が普及している。これは、ビジネスロジックごとにそれぞれ独立したサービスを開発し、それらをAPI(アプリケーションプログラミングインタフェース)で連携させることで1つの大規模なアプリケーションを構築する手法だ。このマイクロサービスアーキテクチャからさらに一歩進んだ手法として、「API設計ファースト」がある。どのような手法なのか。実際の採用例と併せて紹介する。
開発手法“API設計ファースト”とは何か? そのメリットは
イリノイ州シャンバーグに拠点を置く、人事(HR)・給与・経費管理ツールベンダーPaylocityは、1997年に設立された。2000年代中頃、当時としては先進的だったが、異なるサービスを組み合わせてシステムを構築する「サービス指向アーキテクチャ」(SOA)を自社製品に採用した。現在、同社はそれを新たにマイクロサービスアーキテクチャに置き換える作業を進めている。特定のイベントをトリガーにしてプログラムを自動実行する「イベント駆動型プログラミング」も採用しており、各サービスが他のサービスのイベントに応答して動作する仕組みだ。
以前はサービス間の通信にメッセージングツール「RabbitMQ」を使用していたが、SaaS(Software as a Service)連携ツール「AWS EventBridge」に置き換えた。Paylocityのアプリケーションの中核システムの一部はまだ移行の途上にある。
APIを利用するリクエストを制御する仕組み「APIゲートウェイ」も刷新した。Nevatechの「Sentinet」からコンテナオーケストレーションツール「Kubernetes」ベースの「KrakenD」に置き換え済みだ。現在はAPIのガバナンス強化に取り組んでいる。
2025年5月、Paylocityのプリンシパルエンジニアを務めるベン・ヘイル氏は、米国Informa TechTargetのインタビューに答え、次のように語った。「アプリケーション業界において、開発プロセスの革新に終わりはない。私たちの当面の目標は、今後数カ月で、APIゲートウェイのモダナイゼーション(最新化)を完了させることだ。鍵となるのが“API設計ファースト”という原則だ」
「具体的には、各サービスのソースコードを記述する前に、『API仕様』(API Specification、API定義とも)を作成するよう社内ルール化した」と、同氏は説明する。
「このためにKrakenDの商用版『KrakenD Enterprise Edition』を導入した。KrakenD Enterprise EditionはAPI仕様として『OpenAPI Specification』(OAS)をインポートできる。API仕様により、APIの構造とセマンティクス(意味)を人間とコンピュータの両方が容易に理解できるようになり、アプリケーションの開発と改良に役立つ。これがAPI設計ファーストであり、わが社のエンジニア1000人にとっては開発手法の大きなシフトだった」。ヘイル氏はそう語る。
「以前のAPIゲートウェイでは、開発チームがソースコードに『APIフック』(APIの動作を操作するプログラム)を埋め込み、そこからAPI仕様を生成していた。APIゲートウェイはそれに基づいてAPIリクエストを制御していた。今はその逆で、最初にAPI仕様を作成する。完成を受けて、初めて開発者はソースコードを書き始めて“よし”となる」(ヘイル氏)
このアプローチにより、Webアプリケーションやモバイルアプリケーションを担当するフロントエンド開発者は、バックエンドエンジニアがAPIを完成させるのを待つことなく、API仕様に基づいてコーディングを開始でき、開発の自由度が高まる。これはマイクロサービスアーキテクチャへの移行にも役立ち、サードパーティーのAIエージェントからのAPIリクエストを管理する基盤ともなる。全てがAPI設計ファーストというわけだ。
API設計ファーストの実現に役立つツール
しかし、API仕様のファイルを頻繁に使用するのは、特定のタイプのAPIリクエストをグループ化して管理する「APIコレクション」での作業に慣れた開発者にとって困難な場合がある。
「データ記述言語『JSON』形式で記述された、6万3000行にも及ぶAPI仕様ファイルを手動で更新するのは楽しい作業ではないし、役立つ管理ツールも少ない。一部のツールは読み取り専用で、インタラクティブ性やコラボレーション機能に欠けている」とへイル氏は語る。
Paylocityは2023年後半にAPI開発ツール「Postman」を採用しており、同社の開発者の大多数はPostmanに慣れている。2025年4月、Postmanに「Spec Hub」機能が実装された。この機能がAPI仕様の更新に役立つとヘイル氏は期待する。
Postmanを提供するPostman社の創設者兼CEOであるアビナブ・アスタナ氏は、Spec Hubについて次のように語っている。「Spec Hubにより、OASのバージョン3.0、もしくはAPI仕様『AsyncAPI』のバージョン2.0を、APIコレクションとシームレスに同期できるようになった。API仕様からAPIコレクションを生成することも、その逆も可能だ」
「さらに、検証、リンティング(構文やスタイルの自動チェック)、ガバナンスルールを組み込んだ。これにより、API仕様が自社のガバナンスに準拠しているかどうかを確認できる」(アスタナ氏)
現在、Paylocityの開発チームは、開発プロセスにSpec Hubをどう組み入れるか、同社のガバナンス担当チームと話し合っているという。
へイル氏は、開発者が考え方を変革する必要性についても次のように言及する。「API仕様について、“触れたくない。ソースコードを書いてAPIを開発すればいい”という考え方から、“チームと協力でき、ソースコード管理ツール『GitHub』に同期でき、コーディングの際の指針となる素晴らしい設計インタフェースだ”という考え方に移行する必要がある。Postmanならそれが可能だと思う」
翻訳・編集協力:雨輝ITラボ(リーフレイン)
Copyright © ITmedia, Inc. All Rights Reserved.
TechTarget発 世界のインサイト&ベストプラクティス
米国TechTargetの豊富な記事の中から、さまざまな業種や職種に関する動向やビジネスノウハウなどを厳選してお届けします。
この記事の著者
関連記事
新着ホワイトペーパー PR
-
事例
[横河レンタ・リース株式会社] 「Wi-Fiにつながらない」「会議中に途切れる」の原因を切り分けやすくするには -
技術文書・技術解説
[アトラシアン株式会社] AIを導入で終わらせない、個人の利用から組織の成果に変えるリーダーの実践指針 -
製品資料
[アトラシアン株式会社] 生成AIの全社展開とROI最大化を阻む“ナレッジの壁” 突破するための4ステップ -
製品資料
[株式会社Helpfeel] コールセンター長を悩ませる「4大課題」と解決策 -
製品資料
[株式会社Helpfeel] 調査結果で見る「社内問い合わせ」の現状 ストレスや工数圧迫の原因は?
こんなメディアも見られています
TechTargetジャパンに関連する情報をお探しであれば、こちらのメディアもお役に立てるかもしれません。
ベンダーコンテンツ PR
From Informa TechTarget
SpecialPR
アクセスランキング
-
1
「GPT-6.1 Terra」は半額 それでもなぜ企業はAIモデルを選べないのか?
-
2
SAP移行で1900億円の赤字 「ベンダー任せ」が招くERP崩壊と回避策
-
3
AIに長文を入力する際の「コンテキストウィンドウ」の適切な扱い方はどれ?
-
4
社外との大容量データ共有をどう統制する? AbemaTVの「Dropbox」活用術
-
5
冷凍庫が一晩で50℃に 仏約700拠点を襲ったOT攻撃、侵入口は「遠隔管理」
-
6
WordPressサイトの4割が旧版のまま 自動更新が止まる組織の共通点
-
7
「データ活用とAI活用の実態」に関するアンケート
-
8
ユナイテッド航空がAI予約エージェントを遮断、そのとき航空業界は何を失うのか
-
9
「Azure OpenAIなど生成AI」に関するアンケート
-
10
「Confluence」が使うAxisで悪用、BIG-IPも修正――今朝の情シスニュース
ホワイトペーパーランキング PR
-
1
「IT史に名を残すシステム障害」8選
-
2
SCS評価制度時代の「SASE選定」ガイド
-
3
パスワード管理だけで十分? 特権アクセスを脅かす暗号鍵の放置リスクとは
-
4
マンガで解説:情シスの負担を減らす「MDRサービスのインシデント対応」の中身
-
5
すぐ分かる「AWS WAF」ガイド:特徴・運用課題・メリットを解説
-
6
Microsoft 365のメールセキュリティ、3つの“死角”と追加で検討すべき対策とは
-
7
自社のメール環境は本当に安全? チェックシートですぐ分かる“今必要な対策”
-
8
Microsoft 365 Copilotで実際何ができる? 回答の精度を高めるRAGとは?
-
9
「Microsoft 365」徹底解説ガイド テレワーク時代のセキュリティ対策編
-
10
AIに何を聞いても「汎用的な答え」しか返ってこないのはなぜか?
TechTargetジャパン SNS
インフォメーション
注目情報をチェック
TechTargetジャパンをフォロー