Importar uma Aplicação Lógica 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 uma Aplicação Lógica como uma API
  • Testar a API no Portal do Azure

Nota

O Gerenciamento de API oferece suporte à importação automatizada de um recurso de Aplicativo Lógico (Consumo). que é executado no ambiente de Aplicativos Lógicos multilocatário. Saiba mais sobre aplicativos lógicos de locatário único versus multilocatário.

Pré-requisitos

Vá para a sua instância de Gestão de API

  1. No portal do Azure, procure e selecione serviços de Gerenciamento de API.

    Selecionar serviços de gerenciamento de API

  2. Na página Serviços de Gerenciamento de API, selecione sua instância de Gerenciamento de API.

    Selecione sua instância de Gerenciamento de API

Importar e publicar uma API de back-end

  1. Navegue até o serviço de Gerenciamento de API no portal do Azure e selecione APIs no menu.

  2. Selecione Aplicação Lógica na lista Adicionar uma nova API.

    Selecionar categoria de aplicativo lógico

  3. Pressione Procurar para ver a lista de Aplicativos Lógicos com gatilho HTTP em sua assinatura.

    • Os aplicativos lógicos sem gatilho HTTP não aparecerão na lista.

    Procurar aplicativos lógicos existentes com o gatilho correto

  4. Selecione o aplicativo lógico.

    Selecionar aplicativo lógico

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

  6. Adicione um sufixo de URL de API.

    • O sufixo identifica exclusivamente essa API específica nesta instância de Gerenciamento de API.

    Concluir campos

  7. Se você quiser que a API seja publicada e disponibilizada para desenvolvedores, alterne para a visualização Completa e associe-a a um Produto. Usamos o produto "Ilimitado" neste exemplo.

    • Você pode adicionar sua API a um produto durante a criação ou posteriormente através da 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. Uma vez inscritos, eles recebem uma chave de assinatura para qualquer API nesse produto. Como criador da instância de Gerenciamento de API, você é um administrador e está inscrito em todos os produtos por padrão.

    Cada instância de Gerenciamento de API vem com dois produtos de exemplo padrão:

    • Inicial
    • Ilimitado
  8. Insira outras configurações da API.

  9. Selecione Criar.

Testar a API no Portal do Azure

As operações podem ser chamadas diretamente a partir do Portal do Azure, que fornece um meio cómodo para ver e testar as operações de uma API.

Testar a aplicação lógica

  1. Selecione a API que criou no passo anterior.

  2. Prima o separador Teste.

  3. Selecione a operação que pretende testar.

    • A página exibe campos para parâmetros de consulta e cabeçalhos.
    • Um dos cabeçalhos é "Ocp-Apim-Subscription-Key", para a chave de subscrição do produto associada a esta API.
    • Como criador da instância de Gerenciamento de API, você já é um administrador, portanto, a chave é preenchida automaticamente.
  4. Prima Enviar.

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

Anexar outras APIs

Você pode compor uma API de APIs 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
  • Aplicação de Função do Azure
  • Azure Logic Apps
  • Azure Service Fabric

Anexe uma API diferente à sua API existente usando as etapas a seguir.

Nota

Quando importar outra API, as operações são anexadas à API atual.

  1. Aceda à sua instância de API Management do Azure no portal do Azure.

    Ir para a instância do Azure API Mgmt

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

    Selecionar APIs

  3. Clique em ... junto à API à qual quer anexar outra API.

  4. Selecione Importar no menu pendente.

    Selecione Importar

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

    Selecionar serviço

Nota

Cada Aplicação Lógica tem a operação manual-invoke. Para incluir sua API de vários aplicativos lógicos e evitar colisão, você precisa renomear a função. Para renomear a função/API, navegue até o editor de especificações OpenAPI e altere o valor do título.

Próximos passos