次の方法で共有

SOAP API を API Management にインポートして REST に変換する

  • [アーティクル]

適用対象: すべての API Management レベル

この記事では、SOAP API を WSDL 仕様としてインポートし、それを REST API に変換する方法について説明します。 また、API Management で API をテストする方法についても説明します。

この記事では、次のことについて説明します。

  • SOAP API のインポートと REST への変換
  • Azure Portal での API のテスト

Note

WSDL の API Management へのインポートは、特定の制限事項に従います。 wsdl:import、xsd:import、xsd:include の各ディレクティブを含む WSDL ファイルはサポートされていません。 WSDL ファイル内のこれらの依存関係を解決およびマージするオープンソース ツールについては、この GitHub リポジトリを参照してください。

前提条件

次のクイック スタートを完了すること:Azure API Management インスタンスを作成する

API Management インスタンスに移動します。

  1. Azure portal で、[API Management サービス] を検索して選択します。

    [API Management サービス] を選択する

  2. [API Management サービス] ページで、ご自身の API Management インスタンスを選択します。

    API Management インスタンスを選択する

バックエンド API のインポートと公開

  1. 左側のメニューの [API] セクションで [API]>[+ API の追加] を選びます。

  2. [Create from definition](定義から作成) で [WSDL] を選びます。

    SOAP API

  3. [WSDL 仕様] で、SOAP API の URL を入力するか、[ファイルの選択] を選択してローカルの WSDL ファイルを選びます。

  4. [Import method](インポート方法) で [SOAP から REST] を選びます。 このオプションをオンにすると、API Management は XML と JSON の間で自動変換を実行しようとします。 この場合、コンシューマーは JSON を返す API を RESTful API として呼び出す必要があります。 API Management により、各要求は SOAP 呼び出しに変換されます。

    SOAP から REST

  5. [表示名]、[名前]、[説明] の各フィールドには、SOAP API からの情報が自動的に入力されます。 操作には [表示名]、[URL]、[説明] が自動的に入力され、システムによって生成された [名前] を受け取ります。

  6. 他の API 設定を入力します。 値は、作成時に設定することも、後で [設定] タブに移動して構成することもできます。

    API 設定の詳細については、「最初の API のインポートと発行」のチュートリアルを参照してください。

  7. ［作成］ を選択します

Azure portal での新しい API のテスト

Azure Portal には、API の操作を表示およびテストするための便利な環境が用意されており、操作を直接呼び出すことができます。

  1. 前の手順で作成した API を選びます。

  2. [テスト] タブを選びます。

  3. 操作を選択します。

    ページに、クエリ パラメーターのフィールドとヘッダーのフィールドが表示されます。 この API に関連付けられている成果物のサブスクリプション キーの場合、ヘッダーの 1 つは Ocp-Apim-Subscription-Key です。 API Management インスタンスを作成した場合は、既に管理者になっているので、キーが自動的に入力されます。

  4. [送信] をクリックします。

    テストが成功すると、バックエンドから 200 OK といくつかのデータが応答として返されます。

その他の API の追加

次のように、各種サービスで公開される API を構成できます。

  • OpenAPI の仕様
  • SOAP API
  • GraphQL API
  • Azure App Service でホストされる Web アプリ
  • Azure Function App
  • Azure Logic Apps
  • Azure Service Fabric

次の手順に従って、既存の API に別の API を追加します。

Note

別の API をインポートすると、操作が現在の API に追加されます。

  1. Azure portal で Azure API Management インスタンスに移動します。

    ポータルでの API Management インスタンスへの移動のスクリーンショット。

  2. [概要] ページまたは左側のメニューから [API] を選択します。

    ポータルの [概要] ページで API を選択しているスクリーンショット。

  3. 別の API を追加する API の隣の [...] をクリックします。

  4. ドロップダウン メニューから [インポート] を選択します。

    [インポート] を選択する

  5. API のインポート元のサービスを選択します。

    ポータルでサービスを選択しているスクリーンショット。

次のステップ

公開された API の変換と保護