Importar a API SOAP para o Gerenciamento de API e converter em REST
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.
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.
Vá para sua instância de Gerenciamento de API do Azure no portal do Azure.
Selecione APIs na página Visão geral ou no menu à esquerda.
Clique em ... ao lado da API à qual você deseja acrescentar outra API.
Selecione Importar no menu suspenso.
Selecione um serviço de onde será importada a API.
Tópicos relacionados
- Limitações de importação da API
- Importar uma especificação de OpenAPI
- Importar uma API SOAP
- Importar uma API SOAP e converter em REST
- Importar uma API do Serviço de Aplicativo
- Importar uma API do Aplicativo de Contêiner
- Importar uma API WebSocket
- Importar uma API do GraphQL
- Importar um esquema do GraphQL e configurar resolvedores de campo
- Importar um Aplicativo de Funções do Azure
- Importar um Aplicativo Lógico do Azure
- Importar um serviço do Service Fabric
- Importar uma API do OpenAI do Azure
- Importar uma API de OData
- Importar metadados do SAP OData
- Importar uma API do gRPC
- Editar uma API