Chamar pontos de extremidade da API REST de fluxos de trabalho em Aplicativos Lógicos do Azure
Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Padrão)
Para chamar um ponto de extremidade da API REST de um fluxo de trabalho de aplicativo lógico nos Aplicativos Lógicos do Azure, você pode usar as operações internas HTTP + Swagger para chamar qualquer ponto de extremidade da API REST por meio de um Arquivo Swagger. O gatilho e a ação HTTP + Swagger funcionam da mesma forma que o gatilho e ação HTTP, mas fornecem uma experiência melhor no Designer de fluxo de trabalho ao expor a estrutura da API e as saídas descritas pelo arquivo Swagger. Para implementar um gatilho de sondagem, siga o padrão de sondagem descrito em Criar APIs personalizadas para chamar outras APIs, serviços e sistemas de fluxos de trabalho de aplicativos lógicos.
Limitações
As operações internas HTTP + Swagger atualmente suportam apenas OpenAPI 2.0, não OpenAPI 3.0.
Pré-requisitos
Uma conta e uma assinatura do Azure. Se você não tiver uma assinatura do Azure, inscreva-se em uma conta gratuita do Azure.
A URL para o arquivo Swagger que descreve o ponto de extremidade da API REST de destino que você deseja chamar
Normalmente, o ponto de extremidade REST precisa atender aos seguintes critérios para que o gatilho ou a ação funcione:
O arquivo Swagger deve ser hospedado em uma URL HTTPS publicamente acessível.
O arquivo Swagger deve conter uma propriedade operationID para cada operação na definição. Caso contrário, o conector mostrará apenas a última operação no arquivo Swagger.
O arquivo Swagger deve ter o CORS (compartilhamento de recursos entre origens) habilitado.
Observação
Para fazer referência a um arquivo Swagger que não está hospedado ou que não atende aos requisitos de segurança e entre origens, você pode carregar o arquivo Swagger em um contêiner de blob em uma conta de armazenamento do Azure e habilitar o CORS nessa conta de armazenamento para que seja possível referenciar o arquivo.
O fluxo de trabalho do aplicativo lógico de Consumo ou Standard de onde você deseja chamar o ponto de extremidade de destino. Para começar com o gatilho HTTP + Swagger, crie um recurso de aplicativo lógico com um fluxo de trabalho em branco. Para usar a ação HTTP + Swagger, inicie seu fluxo de trabalho com o gatilho que você quiser. Este exemplo usa o gatilho HTTP + Swagger como a primeira operação.
Adicionar um gatilho HTTP + Swagger
Esse gatilho interno envia uma solicitação HTTP para uma URL para um arquivo do Swagger que descreve uma API REST. Em seguida, o gatilho retorna uma resposta que contém o conteúdo desse arquivo.
No portal do Azure, abra o recurso de aplicativo lógico e o fluxo de trabalho em branco no designer.
Com base no fluxo de trabalho de Consumo ou Standard, siga estas etapas gerais para adicionar o gatilho HTTP chamado HTTP + Swagger.
Na caixa Ponto de extremidade do Swagger, insira o URL do arquivo Swagger desejado e selecione Adicionar ação.
O exemplo a seguir usa um URL do Swagger não funcional. Seu URL pode usar um formato diferente.
Depois que o designer mostrar as operações descritas pelo arquivo do Swagger, selecione a operação que você deseja usar.
Forneça os valores para os parâmetros de gatilho (que variam de acordo com a operação selecionada) que você deseja incluir na chamada do ponto de extremidade.
Se o gatilho exigir que você especifique um agendamento de disparo, especifique a recorrência para a frequência com que deseja que o gatilho chame o ponto de extremidade.
Para adicionar outros parâmetros disponíveis, abra a lista Parâmetros avançados e selecione os parâmetros desejados.
Para obter mais informações sobre os tipos de autenticação disponíveis para HTTP + Swagger, confira Adicionar autenticação a chamadas de saída.
Continue construindo seu fluxo de trabalho com as ações que você deseja executar quando o gatilho for acionado.
Quando terminar, salve o fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.
Selecionar uma ação HTTP + Swagger
Esse ação interna envia uma solicitação HTTP para a URL para um arquivo do Swagger que descreve uma API REST. Em seguida, a ação retorna uma resposta que contém o conteúdo desse arquivo.
No portal do Azure, abra o recurso de aplicativo lógico e o fluxo de trabalho no designer.
Com base no fluxo de trabalho de Consumo ou Standard, siga estas etapas gerais para adicionar a ação HTTP chamada HTTP + Swagger.
Na caixa Ponto de extremidade do Swagger, insira o URL do arquivo Swagger desejado e selecione Adicionar ação.
O exemplo a seguir usa um URL do Swagger não funcional. Seu URL pode usar um formato diferente.
Depois que o designer mostrar as operações descritas pelo arquivo do Swagger, selecione a operação que você deseja usar.
Forneça os valores para os parâmetros de ação (que variam conforme a operação selecionada) que você deseja incluir na chamada do ponto de extremidade.
Para adicionar outros parâmetros disponíveis, abra a lista Parâmetros avançados e selecione os parâmetros desejados.
Para obter mais informações sobre os tipos de autenticação disponíveis para HTTP + Swagger, confira Adicionar autenticação a chamadas de saída.
Continue construindo seu fluxo de trabalho com quaisquer outras ações que você deseja executar.
Quando terminar, salve o fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.
Hospedar o Swagger no Armazenamento do Azure
Você ainda pode fazer referência a um arquivo do Swagger que não está hospedado ou que não atende aos requisitos de segurança e entre origens. Upload o arquivo do Swagger para o contêiner de blob em uma conta de armazenamento do Azure e habilitar CORS nessa conta de armazenamento. Para criar, configurar e armazenar arquivos Swagger no Armazenamento do Azure, siga estas etapas:
Agora, habilite o CORS para o blob. No menu da sua conta de armazenamento, selecione CORS. Na guia Serviço Blob, especifique esses valores e selecione Salvar.
Propriedade Valor Origens permitidas *Métodos permitidos GET,HEAD,PUTCabeçalhos permitidos *Cabeçalhos expostos *Idade máxima (em segundos) 200Embora esse exemplo use o portal do Azure, você pode usar uma ferramenta como o Gerenciador de Armazenamento do Azure ou definir essa configuração automaticamente com este exemplo de script do PowerShell.
Criar um contêiner de blob. No painel Visão geral do contêiner, selecione Alterar nível de acesso. Na lista Nível de acesso público, selecione Blob (acesso de leitura anônimo somente para blobs) e selecione OK.
Carregue o arquivo Swagger no contêiner de blob, por meio do portal do Azure ou do Gerenciador de Armazenamento do Azure.
Para fazer referência ao arquivo no contêiner de blob, obtenha a URL HTTPS que segue este formato, que diferencia maiúsculas de minúsculas, no Gerenciador de Armazenamento do Azure:
https://<storage-account-name>.blob.core.windows.net/<blob-container-name>/<complete-swagger-file-name>?<query-parameters>
Referência técnica do conector
Esta seção fornece mais informações sobre as saídas de um gatilho e ação HTTP + Swagger.
Saídas
A chamada HTTP + Swagger retorna as seguintes informações:
| Nome da propriedade | Type | Descrição |
|---|---|---|
| headers | Objeto | Os cabeçalhos da solicitação |
| Corpo | Objeto | O objeto com o conteúdo do corpo da solicitação |
| código de status | Inteiro | O código de status da solicitação |
| Código de status | Descrição |
|---|---|
| 200 | OK |
| 202 | Accepted |
| 400 | Solicitação inválida |
| 401 | Não Autorizado |
| 403 | Proibido |
| 404 | Não encontrado |
| 500 | Erro interno do servidor. Ocorreu um erro desconhecido. |