Freigeben über

Importieren einer SOAP-API in API Management und Konvertieren in REST

GILT FÜR: Alle API Management-Ebenen

In diesem Artikel erfahren Sie, wie Sie eine SOAP-API als WSDL-Spezifikation importieren und dann in eine REST-API konvertieren. Außerdem wird gezeigt, wie Sie die API in Azure API Management testen.

In diesem Artikel werden folgende Vorgehensweisen behandelt:

  • Importieren einer SOAP-API und Konvertieren in REST
  • Testen der API im Azure-Portal

Hinweis

Der WSDL-Import in API Management unterliegt bestimmten Einschränkungen. WSDL-Dateien mit den Anweisungen wsdl:import, xsd:import und xsd:include werden nicht unterstützt. Ein Open-Source-Tool zum Auflösen und Zusammenführen dieser Abhängigkeiten in einer WSDL-Datei finden Sie in diesem GitHub-Repository.

Voraussetzungen

Navigieren zur API Management-Instanz

  1. Suchen Sie im Azure-Portal nach API Management-Dienste, und wählen Sie die entsprechende Option aus:

    Screenshot von API Management-Diensten in den Suchergebnissen

  2. Wählen Sie auf der Seite API Management-Dienste Ihre API Management-Instanz aus:

    Screenshot einer API Management-Instanz auf der Seite „API Management-Dienste“

Importieren und Veröffentlichen einer Back-End-API

  1. Wählen Sie im linken Bereich im Abschnitt APIs die Option APIs aus.

  2. Wählen Sie auf der Seite „APIs“ die Option + API hinzufügen aus.

  3. Wählen Sie unter Aus Definition erstellen die Option WSDL aus:

    Screenshot der WSDL-Kachel im Azure-Portal

  4. Geben Sie unter WSDL-Spezifikation die URL zu Ihrer SOAP-API ein, oder wählen Sie Datei auswählen und dann eine lokale WSDL-Datei aus.

  5. Wählen Sie unter Importmethode die Option SOAP nach REST aus. Bei Verwendung dieser Option versucht API Management eine automatische Transformation zwischen XML und JSON. In diesem Fall sollen Consumer die API als RESTful-API aufrufen, wodurch JSON-Code zurückgegeben wird. API Management konvertiert jede Anforderung in einen SOAP-Aufruf.

    Screenshot der Option „SOAP nach REST“

  6. Die Felder Anzeigename und Name werden automatisch mit Informationen aus der SOAP-API ausgefüllt.

    Die Informationen in Anzeigename, URL und Beschreibung werden für Vorgänge automatisch eingegeben. Vorgänge erhalten auch einen vom System generierten Namen.

  7. Geben Sie andere API-Einstellungen ein, und wählen Sie dann Erstellen aus. Sie können diese Werte auch später auf der Registerkarte Einstellungen konfigurieren.

    Weitere Informationen zu API-Einstellungen finden Sie unter Importieren und Veröffentlichen Ihrer ersten API.

Testen der neuen API im Azure-Portal

Sie können Vorgänge direkt über das Azure-Portal aufrufen. Diese Methode bietet eine bequeme Möglichkeit, die Vorgänge einer API anzuzeigen und zu testen.

  1. Wählen Sie die API aus, die Sie im vorherigen Schritt erstellt haben.

  2. Wählen Sie die Registerkarte Testen aus.

  3. Wählen Sie einen Vorgang aus.

    Auf der Seite werden Felder für Abfrageparameter und Header angezeigt. Einer der Header ist Ocp-Apim-Subscription-Key. Dieser Header ist für den Abonnementschlüssel des Produkts vorgesehen, das dieser API zugeordnet ist. Wenn Sie die API Management-Instanz erstellt haben, sind Sie bereits Admin, sodass der Schlüssel automatisch eingetragen wird.

  4. Wählen Sie Send (Senden) aus.

    Wenn die Anforderung erfolgreich ist, antwortet das Back-End mit 200 OK und einigen Daten.

Anfügen weiterer APIs

Sie können eine API aus APIs zusammensetzen, die von verschiedenen Diensten verfügbar gemacht werden, u. a.:

  • Einer OpenAPI-Spezifikation
  • Einer SOAP-API
  • Einer GraphQL-API
  • Einer Web-App, die in Azure App Service gehostet wird
  • Azure-Funktionen
  • Azure Logic Apps
  • Azure Service Fabric

Hinweis

Wenn Sie eine API importieren, werden die Vorgänge an Ihre aktuelle API angefügt.

So fügen Sie eine API an eine vorhandene API an

  1. Navigieren Sie im Azure-Portal zu Ihrer Azure API Management-Instanz:

    Screenshot der Seite „API Management-Dienste“

  2. Wählen Sie auf der Seite Übersicht die Option APIs oder im Menü auf der linken Seite APIs>APIs aus.

    Screenshot der Auswahl von „APIs“ auf der Seite „Übersicht“

  3. Wählen Sie neben der API, an die Sie eine andere API anfügen möchten, die Auslassungspunkte (...) aus.

  4. Wählen Sie im Dropdownmenü Importieren aus:

    Screenshot des Befehls „Importieren“

  5. Wählen Sie einen Dienst aus, aus dem eine API importiert werden soll.

Verwandte Inhalte