APIゲートウェイとは何か？| 実際にどのような効果があるのか

"API "という言葉が登場したのは、World Wide Webよりもずっと前のこと。最近になって新しい言葉が登場した。 APIゲートウェイ.APIの概念自体がすでにゲートウェイを示唆しているため、最初は少し奇妙に聞こえます。"

よくぞ聞いてくれた！APIという用語は、ワールド・ワイド・ウェブが登場するずっと前に登場したもので、APIが「Application Programming Interface（アプリケーション・プログラミング・インターフェース）」の略であることはご存知だろう。.

しかし、最近になって新しい用語が登場した：「APIゲートウェイ」である。APIの概念自体がすでにゲートウェイを示唆しているため、最初は少し奇妙に聞こえる。APIゲートウェイって何だろう？.

一言で言えば APIゲートウェイは、クライアントとバックエンドサービスの集合体の間に位置する管理ツールです。それぞれが独自のAPIを持っています。

そのため、APIゲートウェイは次のような役割を果たします。 シングル・ポイント・オブ・エントリー は、定義されたAPIのグループのためのものです。この場合のクライアントは、通常、エンドユーザー・アプリケーションとなります。

より技術的な観点からは、APIゲートウェイを、異なるAPIをあたかも1つのAPIであるかのように見せることができる特殊なリバースプロキシとして見ることもできる。.

APIゲートウェイ」という用語は、マイクロサービスの文脈でよく使われる。. マイクロサービスが提供するAPIの粒度は、必要とされるものとは異なることが多い。 これは単純にマイクロサービスのコンセプトに起因するもので、いくつかの小さなピースが小さな異なることをしているのです。

マイクロサービスは一般的にきめ細かいAPIを提供するため、クライアントは複数のサービスとやり取りする必要があります。例えば、ある製品の詳細を簡単に知りたいクライアントは、多数のサービスからデータを取得する必要があります。だからこそ、マイクロサービスの世界ではAPIゲートウェイが意味を持つのです。

このような状況で、マイクロサービス・アーキテクチャの中で、再び APIゲートウェイの目的は、すべてのクライアントに単一のエントリーポイントを提供することです。が、この場合は、これが行われます。 主にクライアントに提供するAPIを簡素化することで.

APIゲートウェイアーキテクチャ

この図では APIゲートウェイはシステムのエッジに位置します。.管理ツールやミドルウェアとして機能し クライアントとバックエンドサービスの集合体の間を仲介する.

これらの バックエンドサービスの変更が可能 の場所、アーキテクチャ、実装（言語、フレームワークなど）を最小限の影響で実現することができます。

APIゲートウェイの古典的な見方」と呼べるものではあるが、マイクロサービスAPIゲートウェイの見方に限定する必要はない。.

もできます。 APIゲートウェイをよりアーキテクチャ的に捉え、デザインパターンとしてとらえる.APIゲートウェイ・パターンは、実際には次のように対応しているので、2つの要素があると言えます。 2つの古典的なGang of Fourデザインパターンアダプターとファサード

のように。 アダプターそのため、インターフェイスに互換性がなくても、コミュニケーションやコラボレーションが可能になります。

のように。 ファサード, APIゲートウェイは、アプリケーションの内部アーキテクチャをカプセル化し、クライアントにAPIを提供する。.

マイクロサービスの視点でもアーキテクチャの視点でも、APIゲートウェイは常にオーケストレーションの役割を担っています。 と、最終的には物事をスムーズに進めるための存在であるべきだと考えています。しかし、概念や定義から結果につなげるにはどうすればいいのでしょうか？

より実践的な側面に飛び込み、どうすれば結果を出せるかを見てみよう。.

そのためには、特定のAPIゲートウェイを使用します。 独自の統合ゲートウェイ「Connect Bridge. .Connect BridgeはSQLを “話す ”シングルエントリー・ポイントだと考えてください。つまり、どのようなコードを使っても（どのようなプログラミング言語でも構わない）、あたかもデータベースのように、通常のCRUDステートメントを通して、このAPIゲートウェイと通信することができる：SELECT、INSERT、UPDATE、DELETE。.

Connect Bridgeには、API経由でアクセスしたいアプリケーションごとに「トランスレーター」（実際には「コネクター」と呼ぶ）がある。このコネクターはSQLステートメントをAPI呼び出しに効果的に変換する。.

Connect Bridgeを使用することで、必要なコードが少なくなり（プロジェクトによっては90%も削減できる）、コードの理解やテストが容易になり、バグの数も大幅に減る。.

面白いのは、Connect Bridgeで作業しているとき、SQLを使用しているという事実が、ターゲットのシステムデータベース、例えばMicrosoft Exchangeのデータベースで作業していると思わせることです。Connect Bridgeはゲートウェイであり、常にAPI経由でターゲットシステムにアクセスしています。.

APIゲートウェイとしてのConnect Bridgeのステップバイステップ

1. 新規またはレガシーアプリケーションのコード
2. ターゲットシステムにデータベースのようにアクセスする標準SQLのCRUD文
3. Connect BridgeはSQLをAPIコールに変換します。
4. 各ターゲットシステムでは、この翻訳は実際にはコネクタで処理されます。

Connect Bridgeで使用できるプログラミング言語について。先に述べたように、Connect Bridgeでは実質的に 何れのプログラミング言語でも.

に対応しているかを確認する必要があります。 ODBC, JDBCまたは Webサービスです。 それができていれば問題ありません。

例えば、Javaを使いたいとしよう。それなら、JDBC接続文字列を生成すれば、Java APIゲートウェイが完成する。.

Node.jsを使いたいですか？Webサービス接続文字列を生成すれば、Node.js APIゲートウェイが完成します。.

これ以上は言えませんが、もうお分かりだと思いますが、お好きなプログラミング言語をお使いください。

Connect Bridgeは有料ツールで、価格は使用するコネクタの数と種類、ユーザー数によって異なります。このAPIゲートウェイの料金の一般的な目安として、月額150ユーロからとなります。価格の詳細については 此処.でご自身でお試しになることをお勧めします。 フリートライアル このようにして、生産性の向上がどの程度になるかを知ることができます。

また、ROIの観点では、ゲートウェイが以下を保証することも考慮する必要があります。 ターゲットシステムがアップグレードされても、最終的なソリューションは機能し続けます。 あなたが書いたコードには何の変更もありません。トラブルはすべてゲートウェイが処理してくれます。

Connect Bridgeの最初のステップを説明するために、ターゲットシステムの例が必要になります。ここでは、Microsoft SharePointを例に挙げますが、他のシステムでもよいでしょう。

1. をリクエストします。 フリートライアル.
2. Connect Bridgeを取り付ける。
3. Connect Bridge Management Studioを使って設定を処理します。
   • APIゲートウェイの認証には2つのステップがあります。SharePointに接続するために、ユーザーは Connect Bridgeで、その後 Connect Bridge は、SharePointに接続する必要があります。
     • SharePoint のアカウントを追加します (Accounts - Add account)。SharePointの認証情報が必要です。.
     • デフォルトのAdministratorユーザーにそのアカウントの使用を許可するか、新規ユーザーを作成してそのユーザーにSharePointアカウントの使用を許可するか。
   • o [New Query]オプションをクリックし、[Connection Browser]をクリックします。SharePoint」コネクタを探し、「DefaultConnection」にたどり着くまで開きます。その上で右クリックし、「Get Connection string」を選択します。適切な接続文字列をコピーします。この文字列はコードに必要となります。

新規クエリ」オプションを使用して、SharePoint から必要なデータを取得するクエリをテストします。ここでは、クエリの例を挙げて説明しますが、クエリはSharePointから必要なものに合わせて調整する必要があります。

New Query "オプションを選択したら、"Connection Browser "を開きます。

1. SharePointコネクタを見つけ、Tablesオプションが表示されるまで開く。スキーマに Site_Pages という “テーブル” が含まれていることがわかります。.
2. クエリを使用することができます。 SELECT UniqueId, ContentType, Created, Modified, ContentVersion FROM Site_Pages LIMIT 10;
   これは、SharePointのサイトページリストから最初の10エントリを選択します。.

データベースを直接使用しているように見えますが、実際には全く違いますのでご注意ください。Connect Bridgeは、APIのみにアクセスして、あたかもデータベースから来たかのようにデータを表示しています。ここでは自由に探索してみてください。また、利用可能なストアドプロシージャを探索することもできます。クエリを作成したら、それをコピーしてください。あなたのコードで必要になるからです。

また、この時点では、単にテストをしているだけであることに注意してください。Connect Bridge Management Studio は、あなたの遊び場と考えることができます。取得したクエリに満足したら、データベースにアクセスするかのように、コードの中でそれを使用するだけです。非常に簡単なことです。

より詳細な情報については、APIゲートウェイのドキュメントを確認することができます。 フリートライアル.また、APIゲートウェイのログを確認することもできますが、Connect Bridgeでは Connect Bridge 管理スタジオ ナビゲーションバーのオプション「Administration Center - System - Logs」を使用して、「ログ」を表示します。

APIゲートウェイの概念は、一見すると理論的なものに聞こえるかもしれませんが、Connect Bridgeのような具体的なツールに焦点を当てれば、その効果をイメージすることは難しくありません。

• 対象となるシステムの数に関わらず、アクセスはAPIゲートウェイに集約される
• 新しいAPIやプログラミング言語を学ぶ必要がないため、エラーを減らし、生産性を向上させることができます。
• メンテナンスも一元化され、分離されています。すべてはAPIゲートウェイ側で行われ、ユーザーのコードには関与しません。また、Connect Bridge自身が各ターゲットシステムに対して前方互換性を保証しています。

ご意見・ご要望がございましたら、下記のフォームにご記入ください。