Nasazování a volání vlastních rozhraní API z pracovních postupů v Azure Logic AppsDeploy and call custom APIs from workflows in Azure Logic Apps

Po Vytvoření vlastních rozhraní API pro použití v pracovních postupech aplikace logiky je nutné nasadit tato rozhraní API předtím, než je můžete volat.After you create your own APIs to use in your logic app workflows, you need to deploy those APIs before you can call them. Rozhraní API můžete nasadit jako webové aplikace, ale zvažte nasazení rozhraní API jako aplikací API, které usnadňuje práci při sestavování, hostování a využívání rozhraní API v cloudu i místně.You can deploy your APIs as web apps, but consider deploying your APIs as API apps, which make your job easier when you build, host, and consume APIs in the cloud and on premises. Nemusíte měnit žádný kód v rozhraních API – stačí kód nasadit do aplikace API.You don't have to change any code in your APIs - just deploy your code to an API app. Své rozhraní API můžete hostovat na Azure App Service, jako je nabídka typu platforma jako služba (PaaS), která poskytuje vysoce škálovatelné a jednoduché hostování rozhraní API.You can host your APIs on Azure App Service, a platform-as-a-service (PaaS) offering that provides highly scalable, easy API hosting.

I když můžete volat libovolné rozhraní API z aplikace logiky, pro dosažení co nejlepších výsledků přidejte metadata Swagger , která popisují operace a parametry vašeho rozhraní API.Although you can call any API from a logic app, for the best experience, add Swagger metadata that describes your API's operations and parameters. Tento dokument Swagger usnadňuje integraci rozhraní API a lepší práci s Logic Apps.This Swagger document helps your API integrate more easily and work better with logic apps.

Nasazení rozhraní API jako webové aplikace nebo aplikace APIDeploy your API as a web app or API app

Předtím, než budete moci volat vlastní rozhraní API z aplikace logiky, nasaďte rozhraní API jako webovou aplikaci nebo aplikaci API a Azure App Service.Before you can call your custom API from a logic app, deploy your API as a web app or API app to Azure App Service. Aby dokument Swagger byl čitelný návrhářem Logic Apps, nastavte vlastnosti definice rozhraní API a zapněte sdílení prostředků mezi zdroji (CORS) pro vaši webovou aplikaci nebo aplikaci API.To make your Swagger document readable by the Logic Apps Designer, set the API definition properties and turn on cross-origin resource sharing (CORS) for your web app or API app.

  1. V Azure Portalvyberte webovou aplikaci nebo aplikaci API.In the Azure portal, select your web app or API app.

  2. V nabídce aplikace, která se otevře, vyberte v části rozhraní API definice rozhraní API.In the app menu that opens, under API, choose API definition. Nastavte umístění definice rozhraní API na adresu URL vašeho swagger.jsv souboru.Set the API definition location to the URL for your swagger.json file.

    Adresa URL se obvykle zobrazuje v tomto formátu: https://{name}.azurewebsites.net/swagger/docs/v1)Usually, the URL appears in this format: https://{name}.azurewebsites.net/swagger/docs/v1)

    Odkaz na dokument Swagger pro vaše vlastní rozhraní API

  3. V části rozhraní API vyberte CORS.Under API, choose CORS. Nastavte zásadu CORS pro Povolené zdroje na ***** (Povolit vše).Set the CORS policy for Allowed origins to '*' (allow all).

    Toto nastavení povoluje žádosti z návrháře aplikace logiky.This setting permits requests from Logic App Designer.

    Povolit žádosti z návrháře aplikace logiky na vaše vlastní rozhraní API

Další informace najdete v tématu hostování rozhraní RESTful API s CORS v Azure App Service.For more information, see Host a RESTful API with CORS in Azure App Service.

Volání vlastního rozhraní API z pracovních postupů aplikací logikyCall your custom API from logic app workflows

Po nastavení vlastností definice rozhraní API a CORS by vaše triggery a akce vlastního rozhraní API měly být k dispozici, abyste je mohli zahrnout do pracovního postupu aplikace logiky.After you set up the API definition properties and CORS, your custom API's triggers and actions should be available for you to include in your logic app workflow.

  • Pokud chcete zobrazit weby, které mají adresy URL OpenAPI, můžete procházet weby předplatného v Návrháři Logic Apps.To view websites that have OpenAPI URLs, you can browse your subscription websites in the Logic Apps Designer.

  • Chcete-li zobrazit dostupné akce a vstupy ukázáním v dokumentu Swagger, použijte akci HTTP + Swagger.To view available actions and inputs by pointing at a Swagger document, use the HTTP + Swagger action.

  • Chcete-li volat libovolné rozhraní API, včetně rozhraní API, která nemají nebo zpřístupňují dokument Swagger, můžete vždy vytvořit požadavek s akcí http.To call any API, including APIs that don't have or expose an Swagger document, you can always create a request with the HTTP action.

Další krokyNext steps