REST API SwaggerファイルのMobile Cloud Serviceへのアップロード

Oracle Mobile Cloud Service (MCS)では、ドキュメントのREST APIに接続するRESTコネクタAPIを作成できます。

Swagger記述子URLを指定した場合、RESTコネクタAPIウィザードは、記述メタデータを調査し、そこからリソースおよびフィールドを取得できます。

現在サポートされているのは、JSON形式のSwaggerメタデータのみです。

RESTコネクタAPIは、データを送受信するために、特定の外部サービスと通信するための構成です。 RESTコネクタAPIは、モバイル・アプリケーションを既存のRESTサービスに接続するための標準的な方法を提供するとともに、Oracle Mobile Cloud Serviceの組込みのセキュリティ機能、診断機能、分析機能から利益を得る方法も提供します。

コネクタAPIは、HTTPSプロトコルを使用してクライアントとサーバー間で情報を通信および渡します。渡される情報は、XMLまたはJSON (JavaScript Object Notation)の形式で指定できます。 RESTには、メッセージ層は含まれません。一連のルールを使用してステートレス・サービスを作成します。

RESTコネクタAPIウィザードを使用して、リモート・サービスの指定やエンドポイントのテスト用のセキュリティ・ポリシーの設定から、RESTコネクタAPIの作成を進めます。また、ウィザードではSwaggerがサポートされます。 Swagger記述子URLを指定すると、ウィザードは、そのファイルから使用可能なエンドポイントをイントロスペクトします。使用可能なリソースが識別されて表示されます。外部サービスのリソースを選択するだけです。

標準のインターネット・アクセス・ポート80および443のみがサポートされています。カスタム・ポートを使用してサービスに接続することはできません。

REST Connector APIウィザードを使用して名前と説明を入力し、タイムアウト設定を指定し、ルールを追加し、セキュリティ・ポリシーを設定し、テストすることで、コネクタAPIを迅速に構成できます。

既存のRESTサービスへの接続の作成は、2つのステップから成る簡易な操作で行うことができます。

RESTコネクタAPIに名前を付けます。
外部サービスへのURLを指定します。

REST Connector APIウィザードで、SwaggerファイルへのURLを指定するページに、内部Oracle API catalog.へのリンクがありますそこからSwagger URLを取得して、ディスクリプタのフィールドに貼り付けることができます。

アクセスするデータ固有のリクエストまたはレスポンスを構成するルールを適用することもできます。また、アクセスするサービス用のクライアント側のセキュリティ・ポリシーを構成し、接続の結果をテストして確認することもできます。

作成されるとすぐに、REST connector APIがConnectorsページにリストされます。 RESTコネクタAPIが少なくとも1つ存在する場合は、サイド・メニューからコネクタをクリックすると、コネクタ・ページに直接移動します。カタログからは、RESTコネクタAPIを選択して編集したり、公開したり、新規バージョンを作成したり、既存のバージョンを更新したり、公開済状態の場合にはデプロイしたり、ごみ箱に移動できます。

詳細は、「Oracle Mobile Cloud, Enterpriseでのアプリケーションの開発」の「RESTコネクタAPI」を参照してください。