Tutorial: SOAP-API erstellen

Online bearbeiten

In diesem Tutorial erfahren Sie, wie Sie eine API-Definition mithilfe einer SOAP -Service-WSDL (Web Service Definition Language ) erstellen. Diese API-Definition erleichtert das Erstellen und Verwalten des Zugriffs auf den SOAP-Service.

Info zu diesem Tutorial

Folgen Sie dieser Anleitung, um eine API in API Manager zu erstellen, indem Sie die WSDL für einen vorhandenen SOAP-Dienst importieren. Sowohl der SOAP-Standard 1.1 als auch der SOAP-Standard 1.2 werden von API Connect unterstützt. Wenn die API aufgerufen wird, verwendet sie eine SOAP-Anforderung aus dem API-Aufrufprogramm zum Stellen einer eigenen Anforderung an den SOAP-Service. Die API gibt dann die Antwort des SOAP-Service zurück. In diesem Tutorial gibt der SOAP-Service den Kontostand eines fiktiven Bankkontos für einen bestimmten Benutzer zurück.

In diesem Tutorial schließen Sie die folgenden Lerneinheiten ab:
  1. SOAP-API erstellen
  2. SOAP-API testen

Vorbereitende Schritte

Hinweis : Der Sandbox-Katalog muss so konfiguriert werden, dass er entweder DataPower® API Gateway oder DataPower Gateway (v5 compatible) oder beide verwendet. Siehe "Kataloge erstellen und konfigurieren ".

SOAP-API erstellen

Führen Sie die folgenden Schritte durch, um eine API für einen vorhandenen SOAP-Service zu erstellen.

  1. Laden Sie die SOAP-WSDL-Datei „ AccountServicing.txt “ herunter. Benennen Sie diese Datei in AccountServicing.wsdl um.
  2. Melden Sie sich bei der Benutzeroberfläche des API-Managers an.
  3. Klicken Sie auf das Symbol „Entwickeln “.

    API-Manager-Bildschirm

  4. Klicken Sie auf „Hinzufügen “ > „API “.

    API-Menü hinzufügen

  5. Stellen Sie sicher, dass OpenAPI 2.0 ausgewählt ist.
  6. Wählen Sie Vom vorhandenen WSDL-Service (SOAP-Proxy) aus. Klicken Sie auf Weiter.

    WSDL-Bestätigungsbildschirm

  7. Ziehen Sie im Abschnitt Dateiupload entweder die Datei AccountServicing.wsdl in den Bereich und legen Sie sie dort ab (Drag and Drop) oder klicken Sie auf den Bereich, um eine Datei aus Ihrem Dateisystem hochzuladen.

    Bildschirm zum Hochladen von WSDL-Dateien

  8. Die Datei wird hochgeladen und von API Connect analysiert. Es wird eine entsprechende Bestätigungsnachricht angezeigt. Klicken Sie auf „Weiter“, um fortzufahren.
  9. Wählen Sie den WSDL-Dienst „ AccountServicing “ aus und klicken Sie auf „Weiter “.

    WSDL-Service-Bildschirm

  10. Lassen Sie die Werte im Abschnitt "Info" unverändert und klicken Sie auf "Weiter ".

    API-Informationen

  11. Stellen Sie im Abschnitt „Sicherheit“ sicher, dass die Kontrollkästchen „Mit Client-ID sichern“ und „ CORS “ aktiviert sind. Klicken Sie Weiter.

    API-Sicherheit und -Veröffentlichung

  12. Es wird nun ein Übers ichtsbildschirm angezeigt.

    Zusammenfassung der Ergebnisse (oben)

  13. Klicken Sie auf "API bearbeiten ".

    API-Infoseite

  14. Klicken Sie auf „Validieren“ > „Mit Spezifikationen “. Ihre SOAP-API ist jetzt online.Information

Sie haben erfolgreich eine SOAP-API erstellt. Die WSDL-Datei hat dabei alle Informationen bereitgestellt, die zum Konfigurieren der API-Eingaben und -Antwort erforderlich waren.

SOAP-API testen

Führen Sie die folgenden Schritte durch, um Ihre SOAP-API zu testen.

  1. Klicken Sie auf die Registerkarte „Test“ der „ AccountServicing “-API.
  2. Klicken Sie auf „Zielkonfiguration“, um das Dialogfeld „Einstellungen“ zu öffnen.
  3. Aktivieren Sie die Einstellung „Automatisch veröffentlichen“ und klicken Sie auf „Einstellungen speichern “. Sie werden sehen, dass die API nun online ist, was durch eine grüne Markierung angezeigt wird.Zielkonfiguration
  4. Klicken Sie unter „Anfrage“ auf „Senden“, um die API zu testen. Die API-Antwort wird im Abschnitt Antwort angezeigt.

Die Themen dieses Tutorials

In diesem Tutorial haben Sie die folgenden Aktivitäten durchgeführt:

  • Erstellen einer SOAP-API-Definition.
  • Testen Ihrer SOAP-API.