Bereitstellen und Aufrufen benutzerdefinierter APIs über Workflows in Azure Logic Apps

Gilt für: Azure Logic Apps (Verbrauch)

Nachdem Sie Ihre eigenen APIs erstellt haben, um sie in Workflows der Logik-App zu verwenden, müssen Sie diese APIs bereitstellen, bevor Sie sie aufrufen können. Sie können Ihre APIs als Web-Apps bereitstellen, sollten jedoch in Erwägung ziehen, Ihre APIs als API-Apps bereitzustellen. Dadurch wird das Erstellen, Hosten und Nutzen der APIs in der Cloud und lokal vereinfacht. Sie müssen keinen Code in Ihren APIs ändern. Stellen Sie einfach Ihren Code für eine API-App bereit. Sie können Ihre APIs in Azure App Service hosten, einem PaaS-Angebot (Platform-as-a-Service), das ein einfaches API-Hosting mit hoher Skalierbarkeit ermöglicht.

Obwohl Sie alle APIs in einem Logik-App-Workflow aufrufen können, sollten Sie für optimale Ergebnisse Swagger-Metadaten hinzufügen, die Ihre API-Vorgänge und -Parameter beschreiben. Dieses Swagger-Dokument erleichtert Ihnen die Integration Ihrer API und hilft bei der Zusammenarbeit Ihrer API mit Logik-App-Workflows.

Bereitstellen der API als Web-App oder API-App

Bevor Sie Ihre benutzerdefinierte API über einen Logik-App-Workflow aufrufen können, müssen Sie die API in Azure App Service als Web-App oder API-App bereitstellen. Sie müssen die Eigenschaften der API-Definition festlegen und die Ressourcenfreigabe zwischen verschiedenen Ursprüngen (Cross-Origin Resource Sharing, CORS) für Ihre Web-App oder API-App aktivieren, damit das Swagger-Dokument vom Workflow gelesen werden kann.

  1. Wählen Sie im Azure-Portal Ihre Web-App oder API-App aus.

  2. Wählen Sie im geöffneten App-Menü unter API die Option API-Definition aus. Legen Sie den Speicherort der API-Definition auf die URL Ihrer Datei swagger.json fest.

    In der Regel wird die URL im folgenden Format dargestellt:https://{name}.azurewebsites.net/swagger/docs/v1)

    Screenshot: Azure-Portal mit geöffnetem Bereich „API-Definition“ der Web-App und Feld „Speicherort der API-Definition“ für die URL zum Swagger-Dokument für Ihre benutzerdefinierte API

  3. Wählen Sie unter API die Option CORS aus. Legen Sie die CORS-Richtlinie für Zulässige Ursprünge auf '*' (alle zulassen) fest.

    Diese Einstellung ermöglicht Anforderungen aus dem Workflow-Designer.

    Screenshot: Bereich „CORS“ der Web-App, in dem „Zulässige Ursprünge“ auf „*“ (alle zugelassen) festgelegt ist

Weitere Informationen finden Sie unter Hosten einer RESTful-API mit CORS in Azure App Service.

Aufrufen der benutzerdefinierten API über Workflows der Logik-App

Nachdem Sie die Eigenschaften der API-Definition und CORS eingerichtet haben, sollten die Auslöser und Aktionen Ihrer benutzerdefinierten API für Sie verfügbar sein, um in den Workflow Ihrer Logik-App aufgenommen zu werden.

  • Durchsuchen Sie Ihre Abonnementwebsites im Workflow-Designer, um Websites mit OpenAPI-URLs anzuzeigen.

  • Verwenden Sie die Aktion „HTTP + Swagger“ , um verfügbare Aktionen und Eingaben durch Verweis auf ein Swagger-Dokument anzuzeigen.

  • Sie können über die HTTP-Aktion jederzeit eine Anforderung erstellen, um alle APIs aufzurufen (einschließlich der APIs, die über kein Swagger-Dokument verfügen bzw. keines verfügbar machen).

Nächste Schritte