Volejte svá vlastní webová rozhraní API a REST rozhraní API z pracovních postupů v Azure Logic Apps

Platí pro: Azure Logic Apps (Consumption + Standard)

Pokud máte existující webová rozhraní API nebo rozhraní REST API, která chcete volat z pracovních postupů v Azure Logic Apps, musíte před voláním těchto rozhraní API nejprve provést několik kroků nastavení. Primárně musíte rozhraní API nasadit jako webové aplikace nebo aplikace API. Tuto úlohu můžete provést hostováním rozhraní API ve službě Azure App Service, což je cloudová platforma, která poskytuje vysoce škálovatelné a snadné hostování rozhraní API.

Ve službě App Service můžete rozhraní API nasadit jako webové aplikace, ale místo toho zvažte nasazení rozhraní API jako aplikací API. Tento přístup usnadňuje práci při sestavování, hostování a využívání rozhraní API v cloudu a v místních prostředích. Pro nasazení do aplikace API nemusíte měnit žádný kód.

Volání libovolného rozhraní API z pracovního postupu je možné, ale pro co nejlepší zážitek se doporučuje přidat do vaší webové nebo API aplikace metadata Swaggeru. Tento dokument Swagger popisuje operace a parametry rozhraní API, které pomáhají pracovním postupům aplikací logiky pracovat lépe a snadněji s vaším rozhraním API. Musíte také nastavit sdílení prostředků mezi zdroji (CORS) ve webové aplikaci nebo aplikaci API, aby váš pracovní postup měl přístup k vašemu rozhraní API.

Tato příručka ukazuje, jak přidat dokument Swaggeru, nastavit CORS pro webovou aplikaci nebo aplikaci API a poskytnout možnosti volání rozhraní API z pracovního postupu po dokončení nasazení a hostování rozhraní API ve službě App Service.

Další informace najdete tady:

• Azure App Service
• Vytvoření a nasazení webové aplikace ASP.NET
• Hostujte RESTful API s CORS ve službě Azure App Service

Požadavky

• Účet Azure s aktivním předplatným. Pokud předplatné nemáte, vytvořte si bezplatný účet.

• Webové rozhraní API nebo rozhraní REST API, které dodržuje některý ze vzorů kompatibilních s pracovními postupy v Azure Logic Apps a je nasazený ve službě App Service jako webová aplikace nebo aplikace API.

  Další informace najdete tady:

  • Vytvoření a nasazení webové aplikace ASP.NET
  • Hostujte RESTful API s CORS ve službě Azure App Service

Přidejte přístup k Swagger a CORS k vaší webové aplikaci nebo aplikaci API.

Když do webové aplikace nebo aplikace API přidáte dokument Swaggeru, může návrhář pracovního postupu v Azure Logic Apps snadněji najít a zobrazit dostupné operace a parametry ve vašem rozhraní API. Musíte také nastavit sdílení prostředků mezi zdroji (CORS) ve webové aplikaci nebo aplikaci API, aby váš pracovní postup měl přístup k vašemu rozhraní API.

Pokud chcete, aby byl dokument Swaggeru čitelný z pracovního postupu v návrháři, nastavte ve webové aplikaci nebo aplikaci API vlastnosti definice rozhraní API a přístup CORS.

1. Na webu Azure Portal vyhledejte a otevřete prostředek webové aplikace nebo aplikace API.

2. Na bočním panelu prostředku aplikace vyberte Přehled.

3. Na kartě Vlastnosti v části Domény z výchozí vlastnosti domény zkopírujte a uložte název webu někam pro další krok.

4. Na bočním panelu prostředku aplikace v části ROZHRANÍ API vyberte definici rozhraní API. Jako umístění definice rozhraní API zadejte adresu URL souboru JSON Swaggeru, který obvykle používá následující formát, ale může se lišit, pokud váš soubor Swagger používá novější specifikaci rozhraní API:

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

   Následující příklad ukazuje adresu URL Swaggeru s novější specifikací rozhraní API:

   

5. Až budete hotovi, vyberte Uložit.

6. Na bočním panelu prostředku aplikace pod API vyberte CORS.

7. V případě povoleného původu nastavte zásadu CORS na *, což znamená povolit vše.

   Toto nastavení umožňuje žádosti od návrháře pracovního postupu v Azure Logic Apps.

   

8. Na panelu nástrojů vyberte Uložit.

Další informace najdete v tématu Hostování rozhraní RESTful API s CORS ve službě Azure App Service.

Zavolejte rozhraní API z pracovního postupu

Po nastavení adresy URL definice rozhraní API a konfiguraci CORS se operace rozhraní API objeví v galerii konektorů, kde je můžete najít a přidat do svého pracovního postupu.

• Pokud chcete zobrazit weby s adresami URL OpenAPI, můžete procházet weby předplatného v návrháři pracovních postupů.

• Pokud chcete zobrazit dostupné akce a vstupy ukázáním na dokument Swagger, použijte trigger nebo akci HTTP + Swagger.

• Vždy můžete vytvořit požadavek pomocí akce HTTP k volání libovolného rozhraní API, včetně těch, která nemají nebo nezpřístupňují dokument Swaggeru.

Související obsah

• Vlastní konektory v Azure Logic Apps