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

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

   

2. 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

1. No menu à esquerda, na seção APIs, selecione APIs>+ Adicionar API.

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

   

3. Na especificação WSDL, insira a URL para sua API SOAP ou clique em 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.

   

5. 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.

6. 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.

7. 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.

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

2. Selecione a guia Testar.

3. 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.

4. 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.

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

   

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

   

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

4. Selecione Importar no menu suspenso.

   

5. 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

Próximas etapas

Transformar e proteger uma API publicada