Implantar e chamar APIs personalizadas de fluxos de trabalho nos Aplicativos Lógicos do Azure

Aplica-se a: Aplicativos Lógicos do Azure (Consumo)

Depois de criar suas próprias APIs para usar em seus fluxos de trabalho de aplicativo lógico, você precisará implantar essas APIs antes de poder chamá-las. Você pode implantar suas APIs como aplicativos Web, mas considere implantar suas APIs como aplicativos de API, o que facilita o trabalho quando você criar, hospedar e consumir APIs locais e na nuvem. Você não precisa alterar o código em suas APIs; basta implantar seu código para um aplicativo de API. Você pode hospedar suas APIs no Serviço de Aplicativo do Azure, uma oferta de PaaS (plataforma como serviço) que fornece uma hospedagem de API fácil e altamente escalonável.

Embora você possa chamar qualquer API de um fluxo de trabalho de aplicativo lógico, para a melhor experiência, adicione metadados do Swagger que descrevem as operações e os parâmetros de sua API. Este documento do Swagger ajuda sua API a se integrar mais facilmente e trabalhar melhor com fluxos de trabalho de aplicativo lógico.

Implantar sua API como um aplicativo Web ou aplicativo de API

Antes de chamar sua API personalizada de um fluxo de trabalho de aplicativo lógico, implante sua API como um aplicativo Web ou aplicativo de API do Serviço de Aplicativo do Azure. Para tornar o documento do Swagger legível pelo seu fluxo de trabalho, configure as propriedades de definição da API e ative o CORS (compartilhamento de recursos entre origens) para seu aplicativo Web ou de API.

  1. No portal do Azure, selecione seu aplicativo Web ou aplicativo de API.

  2. No menu de aplicativos que é aberto, em API, selecione Definição da API. Defina o Localização da definição de API como a URL de seu arquivo swagger.json.

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

    Captura de tela mostrando o portal do Azure com o painel

  3. Em API, selecione CORS. Defina a política de CORS de Origens permitidas como '*' (permitir todos).

    Essa configuração permite solicitações do designer de fluxo de trabalho.

    Captura de tela mostrando o painel

Para obter mais informações, examine Hospedar uma API RESTful com CORS no Serviço de Aplicativo do Azure.

Chamar sua API personalizada de fluxos de trabalho de aplicativo lógico

Depois de configurar as propriedades de definição de API e os CORS, os gatilhos e ações da sua API personalizada devem ficar disponíveis para você incluir em seu fluxo de trabalho de aplicativo lógico.

  • Para exibir sites que têm URLs do OpenAPI, você pode navegar pelos seus sites de assinatura no designer de fluxo de trabalho.

  • Para exibir as ações e entradas disponíveis apontando para um documento do Swagger, use a ação HTTP + Swagger.

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

Próximas etapas