Saját webes API-k és REST API-k meghívása az Azure Logic Apps munkafolyamataiból

A következőkre vonatkozik: Azure Logic Apps (Fogyasztás + Standard)

Ha már rendelkezik olyan webes API-kkal vagy REST API-kkal, amelyeket az Azure Logic Apps munkafolyamataiból szeretne meghívni, először el kell végeznie néhány beállítási lépést, mielőtt meghívhatja ezeket az API-kat. Elsősorban webalkalmazásként vagy API-alkalmazásként kell üzembe helyeznie az API-kat. Ezt a feladatot úgy végezheti el, hogy az API-kat az Azure App Service-ben üzemelteti, amely egy magas skálázható, egyszerű API-üzemeltetést biztosító felhőplatform.

Az App Service-ben webalkalmazásként is üzembe helyezheti az API-kat, de érdemes inkább API-alkalmazásokként üzembe helyezni az API-kat. Ez a megközelítés megkönnyíti a munkát, amikor API-kat hoz létre, üzemeltet és használ a felhőben és a helyszíni környezetekben. Az API-kban lévő kódokat nem kell módosítania az API-alkalmazásokban való üzembe helyezéshez.

Bármilyen API-t meghívhat egy munkafolyamatból, de a legjobb élmény érdekében adjon hozzá Swagger-metaadatokat a webalkalmazáshoz vagy az API-alkalmazáshoz. Ez a Swagger-dokumentum az API-műveleteket és paramétereket ismerteti, amely segít a logikai alkalmazások munkafolyamatainak jobb és egyszerűbb működésében az API-val. Emellett be kell állítania a több forrásból származó erőforrás-megosztást (CORS) a webalkalmazásban vagy az API-alkalmazásban, hogy a munkafolyamat hozzáférhessen az API-hoz.

Ez az útmutató bemutatja, hogyan vehet fel egy Swagger-dokumentumot, állíthatja be a CORS-t a webalkalmazáshoz vagy API-alkalmazáshoz, és hogyan hívhatja meg az API-t egy munkafolyamatból, miután befejezte az API app Service-ben való üzembe helyezését és üzemeltetését.

További információkért lásd:

• Azure App Service
• ASP.NET-webalkalmazás létrehozása és üzembe helyezése
• RESTful API létrehozása és üzemeltetése CORS használatával az Azure App Service-ben

Előfeltételek

• Egy Azure-fiók, aktív előfizetéssel. Ha nem rendelkezik előfizetéssel, hozzon létre egy ingyenes fiókot.

• Egy webes API vagy REST API, amely az Azure Logic Apps munkafolyamataival kompatibilis egyik mintát követi, és webalkalmazásként vagy API-alkalmazásként van üzembe helyezve az App Service-ben.

  További információkért lásd:

  • ASP.NET-webalkalmazás létrehozása és üzembe helyezése
  • RESTful API hosztolása és létrehozása CORS használatával az Azure App Service-ben

Swagger- és CORS-hozzáférés hozzáadása webalkalmazáshoz vagy API-alkalmazáshoz

Amikor Swagger-dokumentumot ad hozzá a webalkalmazáshoz vagy API-alkalmazáshoz, az Azure Logic Apps munkafolyamat-tervezője könnyebben megtalálhatja és megjelenítheti az API-ban elérhető műveleteket és paramétereket. Emellett be kell állítania a több forrásból származó erőforrás-megosztást (CORS) a webalkalmazásban vagy az API-alkalmazásban, hogy a munkafolyamat hozzáférhessen az API-hoz.

Ha a Swagger-dokumentumot olvashatóvá szeretné tenni a munkafolyamatból a tervezőben, állítsa be az API-definíció tulajdonságait és a CORS-hozzáférést a webalkalmazásban vagy az API-alkalmazásban.

1. Az Azure Portalon keresse meg és nyissa meg a webalkalmazás vagy AZ API-alkalmazás erőforrását.

2. Az alkalmazás erőforrás-oldalsávján válassza az Áttekintés lehetőséget.

3. A Tulajdonságok lap Tartományok területén, az Alapértelmezett tartomány tulajdonságból másolja és mentse a webhely nevét valahol a következő lépéshez.

4. Az alkalmazás erőforrás-oldalsávján, az API alatt válassza az API-definíciót. Az API-definíció helyéhez adja meg a Swagger JSON-fájl URL-címét, amely általában a következő formátumot használja, de eltérhet, ha a Swagger-fájl egy újabb API-specifikációt használ:

   https://<website-name>/swagger/docs/v1

   Az alábbi példa egy Swagger URL-címet mutat be az újabb API-specifikációval:

   

5. Amikor elkészült, válassza a Mentés lehetőséget.

6. Az alkalmazás erőforrás-oldalsávján, az API alatt válassza a CORS lehetőséget.

7. Az Engedélyezett forrás beállításnál állítsa a CORS-házirendet "*" értékre, ami azt jelenti, hogy az összeset engedélyezi.

   Ez a beállítás engedélyezi a munkafolyamat-tervezőtől érkező kéréseket az Azure Logic Appsben.

   

8. Az eszköztáron válassza a Mentés lehetőséget.

További információért lásd: RESTful API üzemeltetése CORS használatával az Azure App Service-ben.

API meghívása a munkafolyamatból

Az API-definíció URL-címének és a CORS-nak a beállítása után az API-műveletek megjelennek a csatlakozó galériában, ahol megtalálhatja és hozzáadhatja őket a munkafolyamatához.

• Az OpenAPI URL-címekkel rendelkező webhelyek megtekintéséhez tallózhat az előfizetés webhelyein a munkafolyamat-tervezőben.

• Ha az elérhető műveleteket és bemeneteket egy Swagger-dokumentumra mutatva szeretné megtekinteni, használja a HTTP + Swagger eseményindítót vagy műveletet.

• Bármely API meghívásához, beleértve azokat az API-kat is, amelyek nem rendelkeznek Swagger-dokumentummal vagy nem teszik közzé a dokumentumot, bármikor létrehozhat egy kérést a HTTP-művelettel.

Kapcsolódó tartalom

• Egyéni összekötők az Azure Logic Appsben