Importar a API SOAP para o Gerenciamento de API e converter em REST

Artigo
02/02/2024

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

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

Neste artigo, você aprenderá como:

Importar uma API SOAP e converter em REST
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

Conclua o início rápido a seguir: Criar uma instância do Gerenciamento de API do Azure

Navegar até a instância de Gerenciamento de API

No portal do Azure, pesquise e selecione serviços de Gerenciamento de API.
Na página Serviços de Gerenciamento de API, selecione a sua instância de Gerenciamento de API.

Importar e publicar uma API de back-end

No menu à esquerda, na seção APIs, selecione APIs>+ Adicionar API.
Em Criar com base na definição, selecione WSDL.
Na especificação WSDL, insira a URL para sua API SOAP ou clique em Selecionar um arquivo para selecionar um arquivo WSDL local.
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.
Os campos a seguir são preenchidos 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.
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.
Selecione Criar.

Testar a nova API no portal do Azure

As operações podem ser chamadas diretamente do portal do Azure, o que oferece uma maneira fácil de exibir e testar as operações de uma API.

Selecione a API que você criou na etapa anterior.
Selecione a guia Testar.
Selecione uma operação.

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

Quando a solicitação for realizada com sucesso, o back-end responderá com 200 OK e alguns dados.