Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Van toepassing op: Azure Logic Apps (Verbruik + Standard)
Wanneer u bestaande web-API's of REST API's hebt die u wilt aanroepen vanuit werkstromen in Azure Logic Apps, moet u eerst enkele installatiestappen uitvoeren voordat u deze API's kunt aanroepen. In de eerste plaats moet u uw API's implementeren als web-apps of API-apps. U kunt deze taak uitvoeren door uw API's te hosten op Azure App Service, een cloudplatform dat zeer schaalbare, eenvoudige API-hosting biedt.
In App Service kunt u uw API's implementeren als web-apps, maar in plaats daarvan uw API's als API-apps implementeren. Deze aanpak maakt uw taak eenvoudiger wanneer u API's in de cloud en in on-premises omgevingen bouwt, host en verbruikt. U hoeft geen code in uw API's te wijzigen om te implementeren in een API-app.
U kunt elke API aanroepen vanuit een werkstroom, maar voor de beste ervaring kunt u Swagger-metagegevens toevoegen aan uw web-app of API-app. In dit Swagger-document worden uw API-bewerkingen en -parameters beschreven, zodat werkstromen van logische apps beter en eenvoudiger werken met uw API. U moet ook CORS (Cross-Origin Resource Sharing) instellen in uw web-app of API-app, zodat uw werkstroom toegang heeft tot uw API.
Deze handleiding laat zien hoe u een Swagger-document toevoegt, CORS instelt voor uw web-app of API-app en opties biedt voor het aanroepen van uw API vanuit een werkstroom nadat u de implementatie en hosting voor uw API in App Service hebt voltooid.
Voor meer informatie, zie:
- Azure App Service
- Een ASP.NET-web-app maken en implementeren
- Een RESTful-API maken met CORS in Azure App Service
Vereiste voorwaarden
Een Azure-account met een actief abonnement. Als u geen abonnement hebt, maakt u een gratis account.
Een web-API of REST API die een van de patronen volgt die compatibel zijn met werkstromen in Azure Logic Apps en wordt geïmplementeerd in App Service als een web-app of API-app.
Voor meer informatie, zie:
Swagger- en CORS-toegang tot uw web-app of API-app toevoegen
Wanneer u een Swagger-document toevoegt aan uw web-app of API-app, kan de werkstroomontwerper in Azure Logic Apps de beschikbare bewerkingen en parameters in uw API gemakkelijker vinden en weergeven. U moet ook CORS (Cross-Origin Resource Sharing) instellen in uw web-app of API-app, zodat uw werkstroom toegang heeft tot uw API.
Als u uw Swagger-document leesbaar wilt maken vanuit uw werkstroom in de ontwerpfunctie, stelt u in uw web-app of API-app de API-definitie-eigenschappen en CORS-toegang in.
Zoek en open uw web-app of API-app-resource in Azure Portal.
Selecteer Overzicht in de zijbalk van de app-resource.
Kopieer en sla de naam van de website ergens voor de volgende stap op het tabblad Eigenschappen , onder Domeinen, van de eigenschap Standaarddomein op.
Selecteer de API-definitie in de zijbalk van de app-resource onder API. Voer voor de locatie van de API-definitie de URL in voor uw Swagger JSON-bestand, dat doorgaans de volgende indeling gebruikt, maar kan verschillen als uw Swagger-bestand gebruikmaakt van een nieuwere API-specificatie:
https://<website-name>/swagger/docs/v1In het volgende voorbeeld ziet u een Swagger-URL met de nieuwere API-specificatie:
Wanneer u klaar bent, selecteert u Opslaan.
Selecteer CORS in de zijbalk van de app-resource onder API.
Stel voor Toegestane oorsprong het CORS-beleid in op '*', wat betekent dat alles is toegestaan.
Met deze instelling kunnen aanvragen van de werkstroomontwerper in Azure Logic Apps worden toegeslagen.
Selecteer Opslaan op de werkbalk.
Zie Een RESTful-API hosten met CORS in Azure App Service voor meer informatie.
Uw API aanroepen vanuit uw werkstroom
Nadat u de API-definitie-URL en CORS hebt ingesteld, worden uw API-bewerkingen weergegeven in de connectorgalerie, zodat u deze kunt vinden en toevoegen aan uw werkstroom.
Als u websites met OpenAPI-URL's wilt bekijken, kunt u door uw abonnementswebsites bladeren in de werkstroomontwerper.
Als u beschikbare acties en invoer wilt weergeven door naar een Swagger-document te verwijzen, gebruikt u de HTTP + Swagger-trigger of -actie.
Als u een API wilt aanroepen, inclusief API's die geen Swagger-document hebben of beschikbaar maken, kunt u altijd een aanvraag maken met de HTTP-actie.