本文へスキップ

APIゲートウェイとは?複数のAPIへの入り口をまとめる仕組みを現役エンジニアが解説

#APIゲートウェイ#API#マイクロサービス#未経験#インフラ学習

サービスを細かく分けて作っていくと、利用する側(Webやアプリ)からは「どのサービスにどうアクセスすればいいのか」が分かりにくくなってきます。この問題を解決するための仕組みが「APIゲートウェイ」です。結論から言うと、APIゲートウェイとは、複数のサービスへのアクセスをまとめて受け付け、適切なサービスへ振り分ける「入り口」の役割を持つ仕組みです。この記事では、APIゲートウェイが無いときの困りごとと、どんな役割を担っているのかを未経験向けに解説します。

AWSをブラウザで動かして学ぶ

無料コース「AWSとEC2の観察」。実アカウント不要、料金の心配なしで始められます。

APIゲートウェイとは何か

マイクロサービスとは?を解説した記事で紹介しているように、1つのシステムを複数の小さなサービスに分けて作る構成が増えています。この構成では、利用する側は本来、注文のサービス、在庫のサービス、ユーザー情報のサービスなど、複数の窓口にそれぞれアクセスする必要が出てきます。

APIゲートウェイは、この複数の窓口を1つの入り口にまとめる役割を持つ仕組みです。利用する側はAPIゲートウェイという1つの宛先にリクエストを送るだけでよく、その先にどのサービスが何個あるか、どこに配置されているかを知らなくても利用できるようになります。

APIゲートウェイが無いとどうなるか

APIゲートウェイが無い場合、利用する側のアプリが、どのサービスがどこにあるかを直接知っていなければなりません。サービスの数が増えるたびに、利用する側のアプリも修正が必要になりやすく、サービスの配置が変わったときの影響も広がりやすくなります。

複数のサービスへ個別にアクセスする構成と、APIゲートウェイが入り口をまとめる構成の違い
項目APIゲートウェイが無い場合APIゲートウェイがある場合
アクセス先利用する側が、サービスごとに宛先を知っておく必要がある利用する側は、APIゲートウェイという1つの宛先だけを知っていればよい
認証各サービスがそれぞれ認証の仕組みを持つ必要があるAPIゲートウェイでまとめて認証を確認できる
サービスの変更サービスの配置が変わると、利用する側の修正が必要になりやすいAPIゲートウェイ側の設定を変えれば、利用する側に影響しにくい

APIゲートウェイが担う役割

入り口をまとめる以外にも、APIゲートウェイには次のような役割を持たせることが多いです。

  1. 認証・認可: アクセスしてきた相手が誰で、何を許可されているかをここで確認する
  2. ルーティング: リクエストの内容に応じて、どのサービスに振り分けるかを決める
  3. レート制限: 1人の利用者からのアクセス数が急に増えすぎたときに、一定の範囲に抑える

これらをAPIゲートウェイに集約しておくことで、個々のサービス側は、自分が受け持つ処理そのものに集中できるようになります。認証やレート制限のような共通処理を、サービスごとに毎回作り直さなくて済むのも、APIゲートウェイが選ばれる理由の1つです。

気をつけたい点

便利な一方で、APIゲートウェイはすべてのアクセスが通過する箇所になるため、ここが不調になるとシステム全体に影響が出てしまいます。現役でインフラの現場にいる立場から言うと、APIゲートウェイを冗長化しておくことと、応答が遅くなったときの振る舞いを決めておくことは、導入時にセットで考える必要があると感じています。ロードバランサーの違いを解説した記事で紹介している分散の考え方も、APIゲートウェイを安定させる上で関係してきます。

InfraDojoで学ぶ

InfraDojoなら、APIゲートウェイの土台となるネットワークやAWSの仕組みを、会員登録なしでブラウザ上からその場で練習できます。入り口をまとめるという考え方は、通信の基本が分かっているほど理解しやすくなります。

システム構成の基礎から順番に学びたい場合は、インフラエンジニアの学習ロードマップも参考にしてみてください。

よくある質問

Q. APIゲートウェイとロードバランサーは同じものですか?

役割が異なります。ロードバランサーは同じ処理をする複数のサーバーに負荷を分散する仕組みで、APIゲートウェイは異なる役割を持つ複数のサービスへの入り口をまとめる仕組みです。

Q. APIゲートウェイはどんな場面で使われていますか?

複数のサービスに分かれたシステムで、利用する側からのアクセスを1箇所にまとめたい場面でよく使われています。認証やレート制限を共通化したい場合にも選ばれます。

Q. 未経験でもAPIゲートウェイの設定に関わることはありますか?

運用の中で、APIゲートウェイのルーティング設定やアクセスログを確認する機会はあります。まずは、複数のサービスへの入り口をまとめる役割だと理解しておくと、構成図を見たときに全体像をつかみやすくなります。

Reo|インフラエンジニアのアイコン

この記事を書いた人: InfraDojo運営者(Reo|インフラエンジニア)

現役インフラエンジニア・Udemy講師。SESの現場経験に基づき、未経験からのインフラ転職と学習を支援しています。InfraDojoは、ブラウザ上のターミナルで実際に手を動かして学べるインフラ学習サイトです。

読むだけで終わらせず、今日から手を動かす

InfraDojoは、ブラウザを開くだけでLinux・ネットワーク・AWSの演習ができる学習サイトです。登録は30秒、最初のコースは無料です。

新しい記事やコースをLINEで受け取る

未経験からインフラエンジニアを目指す方向けの情報を、公式LINEで月に数回お届けします。

友だち追加する