Partilhar via

Importar um aplicativo lógico como uma API

APLICA-SE A: Todas as camadas de gerenciamento de API

Este artigo mostra como importar um aplicativo lógico como uma API e testar a API importada.

Nota

Atualmente, esse recurso não está disponível em espaços de trabalho.

Neste artigo, vai aprender a:

  • Importar um aplicativo lógico como uma API
  • Testar a API no Portal do Azure

Nota

O Gerenciamento de API do Azure dá suporte à importação automatizada de um recurso de Aplicativo Lógico (Consumo), que é executado no ambiente de Aplicativos Lógicos multilocatário. Para obter mais informações, consulte Diferenças entre aplicativos lógicos padrão de locatário único e Aplicativos lógicos multilocatários de consumo.

Pré-requisitos

Importar e publicar uma API de back-end

  1. Navegue até o serviço de Gerenciamento de API no portal do Azure.

  2. No menu à esquerda, na seção APIs , selecione APIs e, em seguida, selecione + Adicionar API.

  3. Selecione Aplicação Lógica na lista Criar a partir de recurso do Azure

    Captura de ecrã que mostra o bloco do Logic App.

  4. Selecione Procurar para ver a lista de aplicativos lógicos que têm gatilho HTTP em sua assinatura. (Os aplicativos lógicos que não têm um gatilho HTTP não aparecerão na lista.)

    Captura de ecrã que mostra o botão Procurar.

  5. Selecione o aplicativo lógico:

    Captura de ecrã que mostra a janela Selecionar Logic App para importar.

    O Gerenciamento de API localiza o documento Swagger associado ao aplicativo selecionado, busca-o e importa-o.

  6. Adicione um sufixo de URL de API. O sufixo identifica exclusivamente a API na instância de Gerenciamento de API.

    Captura de ecrã que mostra os valores introduzidos na janela Criar a partir da Aplicação Lógica.

  7. Se desejar que a API seja publicada e disponibilizada aos desenvolvedores, alterne para a visualização Completa e associe a API a um Produto. Este exemplo usa o produto Unlimited . (Você pode adicionar sua API a um produto ao criá-lo ou posteriormente na guia Configurações .)

    Nota

    Produtos são associações de uma ou mais APIs oferecidas aos desenvolvedores por meio do portal do desenvolvedor. Primeiro, os desenvolvedores devem assinar um produto para obter acesso à API. Depois de se inscreverem, eles recebem uma chave de assinatura para qualquer API no produto. Como criador da instância de Gerenciamento de API, você é um administrador e está inscrito em todos os produtos por padrão.

    Em determinadas camadas, cada instância de Gerenciamento de API vem com dois produtos de exemplo padrão:

    • Inicio
    • Ilimitado

  8. Insira outras configurações da API. Você pode definir esses valores ao criar a API ou posterior acessando a guia Configurações . As configurações são explicadas no tutorial Importar e publicar sua primeira API .

  9. Selecione Criar.

Testar a API no Portal do Azure

Você pode chamar operações diretamente do portal do Azure. Esse método fornece uma maneira conveniente de exibir e testar as operações de uma API.

Captura de tela que mostra as etapas para testar uma API.

  1. Selecione a API que você criou na etapa anterior.

  2. Na guia Teste , selecione a operação que você deseja testar.

    • A página exibe campos para parâmetros de consulta e cabeçalhos.
    • Um dos cabeçalhos é Ocp-Apim-Subscription-Key. Esse cabeçalho é para a chave de assinatura do produto associada à API.
    • Como criador da instância de Gerenciamento de API, você é um administrador, portanto, a chave é preenchida automaticamente.

  3. Selecione Enviar. Quando o teste é bem-sucedido, o back-end responde com 200 OK e dados.

Anexar outras APIs

Você pode compor uma API a partir de APIs que são expostas por diferentes serviços, incluindo:

  • Uma especificação OpenAPI
  • UMA API SOAP
  • Uma API GraphQL
  • Um Aplicativo Web hospedado no Serviço de Aplicativo do Azure
  • Funções do Azure
  • Azure Logic Apps
  • Azure Service Fabric

Nota

Quando você importa uma API, as operações são anexadas à sua API atual.

Para acrescentar uma API a uma API existente:

  1. Vá para sua instância de Gerenciamento de API do Azure no portal do Azure:

    Captura de tela que mostra a página de serviços de Gerenciamento de API.

  2. Selecione APIs na página Visão geral ou selecione APIs> APIs no menu à esquerda.

    Captura de tela que mostra a seleção de APIs na página Visão geral.

  3. Selecione as reticências (...) ao lado da API à qual você deseja acrescentar outra API.

  4. Selecione Importar no menu suspenso:

    Captura de tela que mostra o comando Importar.

  5. Selecione um serviço a partir do qual quer importar uma API.

Nota

Cada aplicação lógica tem uma manual-invoke operação. Se você quiser combinar vários aplicativos lógicos em uma API, precisará renomear a função. Para renomear a função/API, altere o valor do título no editor de especificações OpenAPI.

Conteúdo relacionado

  • Last updated on