Compartir a través de

Importación de la API de SOAP a API Management

SE APLICA A: Todos los niveles de API Management

En este artículo se explica cómo importar una especificación WSDL, que es una representación XML estándar de una API de SOAP. En el artículo también se muestra cómo probar la API en API Management.

En este artículo aprenderá a:

  • Importación de una API de SOAP
  • 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.

Prerrequisitos

Importación de una API de back-end

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

  2. En el menú izquierdo, seleccione API>+ Agregar API.

  3. En Create from definition (Crear a partir de la definición), seleccione WSDL.

    API DE SOAP

  4. En WSDL specification (Especificación WSDL), escriba la dirección URL de la API SOAP o haga clic en Select a file (Seleccionar un archivo) para seleccionar un archivo WSDL local.

  5. En Import method (Método Import), el paso a través de SOAP está seleccionado de manera predeterminada. Con esta selección, la API se expone como SOAP y los consumidores de API tienen que usar reglas SOAP. Si desea usar Restify en la API, siga los pasos descritos en Import a SOAP API and convert it to REST (Importación de una API de SOAP y conversión a REST).

    Creación de una API de SOAP a partir de la especificación de WSDL

  6. Los siguientes valores de la API se rellenan automáticamente con la información de la API de SOAP: Nombre para mostrar, Nombre y Descripción. Las operaciones se rellenan automáticamente con el Nombre para mostrar, la Dirección URL y la Descripción, y reciben un Nombre generado por el sistema.

  7. Escriba otros valores de la API. Puede establecer los valores durante la creación o luego accediendo a la pestaña Ajustes.

    Para obtener más información sobre la configuración de API, vea el tutorial Importación y publicación de la primera API.

  8. Seleccione Crear.

Prueba de la nueva API en el portal

Se puede llamar a las operaciones directamente desde el portal, lo que proporciona a los administradores una forma cómoda de ver y de 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 parámetros de consulta y los campos para los encabezados.

    Nota

    En la consola de prueba, API Management rellena automáticamente un encabezado Ocp-Apim-Subscription-Key y configura la clave de suscripción de la suscripción de acceso completo integrada. Esta clave permite el acceso a todas las API de la instancia de API Management. Opcionalmente, se puede mostrar el encabezado Ocp-Apim-Subscription-Key si se selecciona el icono de ojo situado junto a la Solicitud HTTP.

  4. En función de la operación, escriba los valores de los parámetros de consulta, los valores de encabezado o el cuerpo de la solicitud. Seleccione Enviar.

    Cuando la prueba se realiza correctamente, el back-end responde con un código de respuesta HTTP correcto y algunos datos.

    Sugerencia

    De forma predeterminada, la consola de prueba envía una solicitud al proxy CORS de API Management, que reenvía la solicitud a la instancia de API Management, que la reenvía al back-end. Este proxy usa la dirección IP pública 13.91.254.72 y solo puede acceder a los puntos de conexión públicos. Si desea enviar una solicitud directamente desde el explorador al servicio API Management, seleccione Omitir proxy CORS. Use esta opción si desea usar la consola de prueba y la puerta de enlace de API Management está aislada de red o no permite el tráfico desde el proxy CORS.

Para depurar una API, consulte Tutorial: Depuración de las API con el seguimiento de solicitudes.

Acción SOAP con caracteres comodín

Si necesita pasar una solicitud SOAP que no tenga una acción dedicada definida en la API, puede configurar una acción SOAP con caracteres comodín. La acción de carácteres comodín coincidirá con cualquier solicitud SOAP que no esté definida en la API.

Para definir una acción SOAP con caracteres comodín:

  1. En el portal, seleccione la API que creó en el paso anterior.
  2. En la pestaña Diseño, seleccione + Agregar operación.
  3. Escriba un nombre para mostrar para la operación.
  4. En la dirección URL, seleccione POST y escriba /?soapAction={any} en el recurso. El parámetro de plantilla dentro de las llaves es arbitrario y no afecta a la ejecución.

Nota

No use el editor de especificación OpenAPI en la pestaña Diseño para modificar una API SOAP.

Anexión de otras API

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

  • Una especificación de OpenAPI
  • Una API SOAP
  • GraphQL API
  • 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:

    Recorte de pantalla que muestra la página servicios de API Management.

  2. Seleccione API en la página Información general o seleccione API >API en el menú de la izquierda.

    Recorte de pantalla que muestra la selección de las API en la página Información general.

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

  4. Seleccione Importar en el menú desplegable:

    Recorte de pantalla que muestra el comando Importar.

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

Contenido relacionado