Implementar e chamar APIs personalizadas a partir dos fluxos de trabalho no Azure Logic Apps

Aplica-se a: Azure Logic Apps (Consumo)

Depois de criar as suas próprias APIs para utilizar nos fluxos de trabalho da aplicação lógica, tem de implementar essas APIs antes de poder chamá-las. Pode implementar as SUAS APIs como aplicações Web, mas considere implementar as SUAS APIs como aplicações de API, o que facilita a criação, o anfitrião e o consumo de APIs na cloud e no local. Não tem de alterar nenhum código nas suas APIs- basta implementar o código numa aplicação de API. Pode alojar as suas APIs no Serviço de Aplicações do Azure, uma oferta de plataforma como serviço (PaaS) que fornece alojamento de API altamente dimensionável e fácil.

Embora possa chamar qualquer API a partir de um fluxo de trabalho de aplicação lógica, para obter a melhor experiência, adicione metadados do Swagger que descrevam as operações e os parâmetros da sua API. Este documento swagger ajuda a sua API a integrar-se mais facilmente e a trabalhar melhor com fluxos de trabalho de aplicações lógicas.

Implementar a API como uma aplicação Web ou aplicação API

Antes de poder chamar a API personalizada a partir de um fluxo de trabalho de aplicação lógica, implemente a sua API como uma aplicação Web ou aplicação API para Serviço de Aplicações do Azure. Para tornar o seu documento Swagger legível pelo fluxo de trabalho, defina as propriedades de definição da API e ative a partilha de recursos de origem cruzada (CORS) para a sua aplicação Web ou aplicação API.

  1. No portal do Azure, selecione a sua aplicação Web ou aplicação API.

  2. No menu da aplicação que é aberto, em API, selecione Definição de API. Defina a localização da definição da API para o URL do ficheiro swagger.json.

    Normalmente, o URL é apresentado neste formato: https://{name}.azurewebsites.net/swagger/docs/v1)

    Captura de ecrã a mostrar portal do Azure com o painel

  3. Em API, selecione CORS. Defina a política CORS para Origens permitidas como "*" (permitir tudo).

    Esta definição permite pedidos do estruturador de fluxos de trabalho.

    Captura de ecrã a mostrar o painel

Para obter mais informações, veja Alojar uma API RESTful com CORS no Serviço de Aplicações do Azure.

Chamar a API personalizada a partir de fluxos de trabalho de aplicações lógicas

Depois de configurar as propriedades de definição da API e o CORS, os acionadores e ações da API personalizada devem estar disponíveis para incluir no fluxo de trabalho da aplicação lógica.

  • Para ver sites com URLs openAPI, pode navegar nos sites da subscrição no estruturador de fluxos de trabalho.

  • Para ver as ações e entradas disponíveis ao apontar para um documento swagger, utilize a ação HTTP + Swagger.

  • Para chamar qualquer API, incluindo APIs que não têm ou expõem um documento swagger, pode sempre criar um pedido com a ação HTTP.

Passos seguintes