Importación de una API SOAP en Azure API Management y conversión en REST

SE APLICA A: Todos los niveles de API Management

En este artículo se muestra cómo importar una API de SOAP como una especificación WSDL y, a continuación, convertirla en una API REST. También se muestra cómo probar la API en Azure API Management.

En este artículo aprenderá a:

• Importación de una API SOAP y conversión en REST
• Prueba de la API en Azure Portal

Nota:

La importación de WSDL a API Management está sujeta a ciertas limitaciones. No se admiten archivos WSDL con las directivas wsdl:import, xsd:import y xsd:include. Para obtener una herramienta de código abierto para resolver y combinar estas dependencias en un archivo WSDL, consulte este repositorio GitHub.

Requisitos previos

• Cree una instancia de Azure API Management.

Vaya a la instancia de API Management.

1. En Azure Portal, busque y seleccione Servicios de API Management:

   

2. En la página Servicios de API Management , seleccione la instancia de API Management:

   

Importación y publicación de una API de back-end

1. En el menú de la barra lateral, en la sección API , seleccione API.

2. En la página API, seleccione + Agregar API.

3. En Crear a partir de la definición, seleccione el icono de WSDL :

   

4. En especificación WSDL, escriba la dirección URL de la API SOAP o elija Seleccionar un archivo para seleccionar un archivo WSDL local.

5. En Método de importación, seleccione SOAP en REST.

   Cuando se hace clic en esta opción, API Management trata de realizar una transformación automática entre XML y JSON. En este caso, los consumidores deben llamar a la API como API RESTful, que devuelve JSON. API Management convierte cada solicitud en una llamada SOAP.

   

6. Los cuadros Nombre para mostrar y Nombre se rellenan automáticamente con información de la API SOAP.

7. Escriba otra configuración de API y, a continuación, seleccione Crear. También puede configurar estos valores más adelante; para ello, vaya a la pestaña Configuración .

   Para obtener más información sobre la configuración de API, consulte Importación y publicación de una API de back-end.

Prueba de la nueva API en Azure Portal

Puede llamar a operaciones directamente desde Azure Portal. Este método proporciona una manera cómoda de ver y probar las operaciones de una API.

1. Seleccione la API que creó en los pasos anteriores.

2. Seleccione la pestaña Prueba.

3. Seleccione una operación.

   La página muestra los campos de los parámetros de consulta y los campos para los encabezados. Uno de los encabezados es Ocp-Apim-Subscription-Key. Este encabezado es para la clave de suscripción del producto asociado a esta API. Si ha creado la instancia de API Management, significa que ya es el administrador, por lo que la clave se rellena automáticamente.

4. Seleccione Enviar.

   Si la prueba se completa correctamente, el back-end responde con 200 - Correcto y algunos datos.

Anexión de otras API

Puede crear una API fuera de las API expuestas por diferentes servicios, entre las que se incluyen:

• Especificación de OpenAPI
• Una API SOAP
• Una API de GraphQL
• Una aplicación web hospedada en Azure App Service
• Funciones de Azure
• Azure Logic Apps
• Azure Service Fabric

Nota:

Al importar una API, las operaciones se anexan a la API actual.

Para anexar una API a una API existente:

1. Vaya a la instancia de Azure API Management en Azure Portal:

   

2. Seleccione APIs en la página Overview o seleccione APIs>APIs en el menú de la barra lateral.

   

3. Seleccione los puntos suspensivos (...) junto a la API que desea anexar a otra API.

4. Seleccione Importar en el menú contextual:

   

5. Seleccione un servicio desde el que se va a importar una API.

Contenido relacionado

• Limitaciones de importación de API
• Importación de una especificación de OpenAPI
• Importación de una API de SOAP
• Importar una API de SOAP y convertir en REST
• Importación de App Service API
• Importación de una API de aplicación de contenedor
• Importar una API de WebSocket
• Importar API de GraphQL
• Importar un esquema GraphQL y configurar solucionadores de campos
• Importación de una API de aplicación de funciones
• Importación de una API de aplicación lógica
• Importación de un servicio Service Fabric
• Importación de una API de Microsoft Foundry
• Importar una API de Azure OpenAI
• Importación de una API de LLM
• Importar una API de OData
• Exportación de una API REST como servidor MCP
• Exposición de un servidor MCP existente
• Importación de una API de agente de A2A
• Importar metadatos de SAP OData
• Importar una API de gRPC
• Edición de una API