サービスを細かく分けて作っていくと、利用する側(Webやアプリ)からは「どのサービスにどうアクセスすればいいのか」が分かりにくくなってきます。この問題を解決するための仕組みが「APIゲートウェイ」です。結論から言うと、APIゲートウェイとは、複数のサービスへのアクセスをまとめて受け付け、適切なサービスへ振り分ける「入り口」の役割を持つ仕組みです。この記事では、APIゲートウェイが無いときの困りごとと、どんな役割を担っているのかを未経験向けに解説します。
APIゲートウェイとは何か
マイクロサービスとは?を解説した記事で紹介しているように、1つのシステムを複数の小さなサービスに分けて作る構成が増えています。この構成では、利用する側は本来、注文のサービス、在庫のサービス、ユーザー情報のサービスなど、複数の窓口にそれぞれアクセスする必要が出てきます。
APIゲートウェイは、この複数の窓口を1つの入り口にまとめる役割を持つ仕組みです。利用する側はAPIゲートウェイという1つの宛先にリクエストを送るだけでよく、その先にどのサービスが何個あるか、どこに配置されているかを知らなくても利用できるようになります。
APIゲートウェイが無いとどうなるか
APIゲートウェイが無い場合、利用する側のアプリが、どのサービスがどこにあるかを直接知っていなければなりません。サービスの数が増えるたびに、利用する側のアプリも修正が必要になりやすく、サービスの配置が変わったときの影響も広がりやすくなります。

| 項目 | APIゲートウェイが無い場合 | APIゲートウェイがある場合 |
|---|---|---|
| アクセス先 | 利用する側が、サービスごとに宛先を知っておく必要がある | 利用する側は、APIゲートウェイという1つの宛先だけを知っていればよい |
| 認証 | 各サービスがそれぞれ認証の仕組みを持つ必要がある | APIゲートウェイでまとめて認証を確認できる |
| サービスの変更 | サービスの配置が変わると、利用する側の修正が必要になりやすい | APIゲートウェイ側の設定を変えれば、利用する側に影響しにくい |
APIゲートウェイが担う役割
入り口をまとめる以外にも、APIゲートウェイには次のような役割を持たせることが多いです。
- 認証・認可: アクセスしてきた相手が誰で、何を許可されているかをここで確認する
- ルーティング: リクエストの内容に応じて、どのサービスに振り分けるかを決める
- レート制限: 1人の利用者からのアクセス数が急に増えすぎたときに、一定の範囲に抑える
これらをAPIゲートウェイに集約しておくことで、個々のサービス側は、自分が受け持つ処理そのものに集中できるようになります。認証やレート制限のような共通処理を、サービスごとに毎回作り直さなくて済むのも、APIゲートウェイが選ばれる理由の1つです。
気をつけたい点
便利な一方で、APIゲートウェイはすべてのアクセスが通過する箇所になるため、ここが不調になるとシステム全体に影響が出てしまいます。現役でインフラの現場にいる立場から言うと、APIゲートウェイを冗長化しておくことと、応答が遅くなったときの振る舞いを決めておくことは、導入時にセットで考える必要があると感じています。ロードバランサーの違いを解説した記事で紹介している分散の考え方も、APIゲートウェイを安定させる上で関係してきます。
InfraDojoで学ぶ
InfraDojoなら、APIゲートウェイの土台となるネットワークやAWSの仕組みを、会員登録なしでブラウザ上からその場で練習できます。入り口をまとめるという考え方は、通信の基本が分かっているほど理解しやすくなります。
システム構成の基礎から順番に学びたい場合は、インフラエンジニアの学習ロードマップも参考にしてみてください。
よくある質問
Q. APIゲートウェイとロードバランサーは同じものですか?
役割が異なります。ロードバランサーは同じ処理をする複数のサーバーに負荷を分散する仕組みで、APIゲートウェイは異なる役割を持つ複数のサービスへの入り口をまとめる仕組みです。
Q. APIゲートウェイはどんな場面で使われていますか?
複数のサービスに分かれたシステムで、利用する側からのアクセスを1箇所にまとめたい場面でよく使われています。認証やレート制限を共通化したい場合にも選ばれます。
Q. 未経験でもAPIゲートウェイの設定に関わることはありますか?
運用の中で、APIゲートウェイのルーティング設定やアクセスログを確認する機会はあります。まずは、複数のサービスへの入り口をまとめる役割だと理解しておくと、構成図を見たときに全体像をつかみやすくなります。