Importar a API SOAP para o Gerenciamento de API

  • Artigo

APLICA-SE A: todas as camadas do Gerenciamento de API

Este artigo mostra como importar uma especificação WSDL, que é uma representação XML padrão da API SOAP. O artigo também mostra como testar a API do Gerenciamento de API.

Neste artigo, você aprenderá como:

  • Importar uma API SOAP
  • Testar a API no Portal do Azure

Observação

A importação do WSDL para Gerenciamento de API está sujeita a determinadas limitações. Arquivos WSDL com diretivas wsdl:import, xsd:import e xsd:include não são compatíveis. Para uma ferramenta de código aberto resolver e mesclar essas dependências em um arquivo WSDL, consulte este repositório GitHub.

Pré-requisitos

Importar uma API de back-end

  1. No portal do Azure, navegue até a instância do Gerenciamento de API.

  2. No menu à esquerda, selecione APIs >+ Adicionar API.

  3. Em Criar com base na definição, selecione WSDL.

    API SOAP

  4. Na especificação WSDL, insira a URL para sua API SOAP ou clique em Selecionar um arquivo para selecionar um arquivo WSDL local.

  5. Em Importar método, a passagem SOAP é selecionada por padrão. Com essa seleção, a API é exposta como SOAP, e os consumidores da API têm que usar regras SOAP. Se você quiser "restify" a API, siga as etapas em Import a SOAP API and convert it to REST (Importar uma API SOAP e convertê-la para REST).

    Criar a API SOAP com base na especificação WSDL

  6. As configurações de API a seguir são preenchidas automaticamente com informações da API SOAP: Nome de exibição, Nome, Descrição. As operações são preenchidas automaticamente com Nome de exibição, URL e Descriçãoe recebem um Nome gerado pelo sistema.

  7. Insira outras configurações de API. Você pode definir os valores durante a criação ou configurá-los mais tarde, acessando a guia Configurações.

    Para obter mais informações sobre configurações de API, confira o tutorial Importar e publicar sua primeira API.

  8. Selecione Criar.

Testar a nova API no portal

As operações podem ser chamadas diretamente do portal, que fornece uma maneira conveniente para administradores exibirem e testarem as operações de uma API.

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

  2. Selecione a guia Testar.

  3. Selecione uma operação. A página exibe os campos dos parâmetros de consulta e os campos dos cabeçalhos.

    Observação

    No console de teste, o Gerenciamento de API preenche automaticamente um cabeçalho Ocp-Apim-Subscription-Key e configura a chave de assinatura da assinatura interna de acesso total. Essa chave permite o acesso a todas as API na instância de Gerenciamento de API. Opcionalmente, exiba o cabeçalho Ocp-Apim-Subscription-Key selecionando o ícone "olho" ao lado da Solicitação HTTP.

  4. Dependendo da operação, insira valores de parâmetro de consulta, valores de cabeçalho ou um corpo da solicitação. Selecione Enviar.

    Quando o teste é bem-sucedido, o back-end responde com um código de resposta HTTP bem-sucedido e alguns dados.

    Dica

    Por padrão, o console de teste envia uma solicitação para o proxy CORS do Gerenciamento de API, que encaminha a solicitação para a instância Gerenciamento de API, que a encaminha para o back-end. Esse proxy usa o endereço de IP público 13.91.254.72 e só pode alcançar pontos de extremidade públicos. Se você quiser enviar uma solicitação diretamente do navegador para o serviço Gerenciamento de API, selecione Ignorar proxy CORS. Use essa opção quando quiser usar o console de teste e o gateway do Gerenciamento de API estiver isolado na rede ou não permitir o tráfego do proxy CORS.

Para depurar uma API, confira o Tutorial: Depurar suas APIs usando o rastreamento de solicitações.

Ação de SOAP curinga

Se você precisar passar uma solicitação de SOAP que não tenha uma ação dedicada definida na API, poderá configurar uma ação de SOAP curinga. A ação curinga corresponderá a qualquer solicitação de SOAP que não está definida na API.

Para definir uma ação de SOAP curinga:

  1. No portal, selecione a API que você criou na etapa anterior.
  2. Na guia Design, selecione + Adicionar Operação.
  3. Insira um Nome de exibição para a operação.
  4. Em URL, selecione POST e insira /soapAction={any} no recurso. O parâmetro de modelo dentro dos colchetes é arbitrário e não afeta a execução.

Acrescentar outras APIs

Você pode compor uma API de APIs expostas por diferentes serviços, incluindo:

  • Uma especificação do OpenAPI
  • Uma API SOAP
  • Uma API da GraphQL
  • Um aplicativo Web hospedado no Serviço de Aplicativo do Azure
  • Aplicativo de Funções do Azure
  • Aplicativos Lógicos do Azure
  • Azure Service Fabric

Acrescente uma API diferente da API existente usando as etapas a seguir.

Observação

Ao importar outra API, as operações são acrescentadas à sua API atual.

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

    Acessar a instância do Gerenciamento de API do Azure

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

    Selecionar APIs

  3. Clique em ... ao lado da API à qual você deseja acrescentar outra API.

  4. Selecione Importar no menu suspenso.

    Selecionar Importar

  5. Selecione um serviço de onde será importada a API.

    Selecione o serviço

Próximas etapas

Transformar e proteger uma API publicada