Importe a API SOAP para o Gerenciamento de API e converta em REST

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

Este artigo mostra como importar uma API SOAP como uma especificação WSDL e, em seguida, convertê-la em uma API REST. O artigo também mostra como testar a API no Gerenciamento de API.

Neste artigo, vai aprender a:

  • Importar uma API SOAP e converter em REST
  • Testar a API no Portal do Azure

Nota

A importação de WSDL para o Gerenciamento de API está sujeita a certas limitações. Não há suporte para arquivos WSDL com wsdl:import, xsd:importe xsd:include diretivas. Para obter uma ferramenta de código aberto para resolver e mesclar essas dependências em um arquivo WSDL, consulte este repositório GitHub.

Pré-requisitos

Concluir o início rápido seguinte: Criar uma instância da Gestão de API do Azure

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. No menu à esquerda, na seção APIs, selecione APIs>+ Add API.

  2. Em Criar a partir da definição, selecione WSDL.

    API SOAP

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

  4. Em Método de importação, selecione SOAP para REST. Quando essa opção é selecionada, o Gerenciamento de API tenta fazer uma transformação automática entre XML e JSON. Nesse caso, os consumidores devem chamar a API como uma API RESTful, que retorna JSON. O Gerenciamento de API converte cada solicitação em uma chamada SOAP.

    SOAP para REST

  5. Os seguintes campos são preenchidos automaticamente com informações da API SOAP: Nome para exibição, Nome, Descrição. As operações são preenchidas automaticamente com Nome para exibição, URL e Descrição e recebem um Nome gerado pelo sistema.

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

    Para obter mais informações sobre configurações de API, consulte Importar e publicar seu primeiro tutorial de API .

  7. Selecione Criar.

Testar a nova 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.

  1. Selecione a API que criou no passo anterior.

  2. Selecione o separador Teste.

  3. Selecione uma operação.

    A página mostra campos para parâmetros de consulta e campos para os cabeçalhos. Um dos cabeçalhos é Ocp-Apim-Subscription-Key, para a chave de subscrição do produto que está associado a esta API. Se você criou a instância de Gerenciamento de API, já é um administrador, portanto, a chave é preenchida automaticamente.

  4. Prima Enviar.

    Quando o teste é bem-sucedido, o back-end responde com 200 OK e alguns 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

Próximos passos