Wdrażanie i wywoływanie niestandardowych interfejsów API z przepływów pracy w usłudze Azure Logic Apps
Dotyczy: Azure Logic Apps (Zużycie)
Po utworzeniu własnych interfejsów API do użycia w przepływach pracy aplikacji logiki należy wdrożyć te interfejsy API przed ich wywołaniem. Interfejsy API można wdrażać jako aplikacje internetowe, ale należy rozważyć wdrożenie interfejsów API jako aplikacji interfejsu API, co ułatwia pracę podczas kompilowania, hostowania i korzystania z interfejsów API w chmurze i lokalnie. Nie musisz zmieniać żadnego kodu w interfejsach API — wystarczy wdrożyć kod w aplikacji interfejsu API. Interfejsy API można hostować na Azure App Service platformie jako usługa (PaaS), która zapewnia wysoce skalowalne i łatwe hostowanie interfejsów API.
Mimo że można wywołać dowolny interfejs API z przepływu pracy aplikacji logiki, aby uzyskać najlepsze środowisko, dodaj metadane struktury Swagger opisujące operacje i parametry interfejsu API. Ten dokument struktury Swagger ułatwia integrację interfejsu API i lepszą pracę z przepływami pracy aplikacji logiki.
Wdrażanie interfejsu API jako aplikacji internetowej lub aplikacji interfejsu API
Zanim będzie można wywołać niestandardowy interfejs API z przepływu pracy aplikacji logiki, wdróż interfejs API jako aplikację internetową lub aplikację interfejsu API, aby Azure App Service. Aby dokument programu Swagger był czytelny dla przepływu pracy, ustaw właściwości definicji interfejsu API i włącz współużytkowanie zasobów między źródłami (CORS) dla aplikacji internetowej lub aplikacji interfejsu API.
W Azure Portal wybierz aplikację internetową lub aplikację interfejsu API.
W wyświetlonym menu aplikacji w obszarze INTERFEJS API wybierz pozycję Definicja interfejsu API. Ustaw lokalizację definicji interfejsu API na adres URL pliku swagger.json.
Zazwyczaj adres URL jest wyświetlany w tym formacie:
https://{name}.azurewebsites.net/swagger/docs/v1)
W obszarze INTERFEJS API wybierz pozycję CORS. Ustaw zasady CORS dla pozycji Dozwolone źródła na wartość "*" (zezwalaj wszystkim).
To ustawienie zezwala na żądania od projektanta przepływu pracy.
Aby uzyskać więcej informacji, zobacz Hostowanie interfejsu API RESTful z mechanizmem CORS w Azure App Service.
Wywoływanie niestandardowego interfejsu API z przepływów pracy aplikacji logiki
Po skonfigurowaniu właściwości definicji interfejsu API i mechanizmu CORS wyzwalacze i akcje niestandardowego interfejsu API powinny być dostępne do uwzględnienia w przepływie pracy aplikacji logiki.
Aby wyświetlić witryny internetowe z adresami URL interfejsu OpenAPI, możesz przeglądać witryny internetowe subskrypcji w projektancie przepływu pracy.
Aby wyświetlić dostępne akcje i dane wejściowe, wskazując dokument struktury Swagger, użyj akcji HTTP + Swagger.
Aby wywołać dowolny interfejs API, w tym interfejsy API, które nie mają lub uwidocznić dokument struktury Swagger, zawsze możesz utworzyć żądanie za pomocą akcji HTTP.