Usa un proxy para un servicio de SOAP

En este instructivo, aprenderás a colocar un proxy de API de Edge frente a un servicio web basado en SOAP.

En este instructivo, se muestra cómo generar una nueva API de REST frente a tu servicio basado en SOAP. Aunque no se describe en detalle aquí, también puedes generar un proxy de paso que acepte una carga útil de SOAP y la pase al servicio de backend.

Requisitos

• Una cuenta de Apigee Edge. Si aún no tienes una, puedes registrarte con las instrucciones en Crea una cuenta de Apigee Edge.

Crea el proxy

Aquí, Edge generará el proxy que se ubicará frente a un servicio de SOAP. Existen dos tipos de proxies de API de SOAP:

• El tipo de proxy REST-SOAP-REST genera una nueva API de REST con una capa de traducción a SOAP. Los clientes la llaman como lo harían con otros servicios de REST, pasando los parámetros de consulta que necesita el servicio de backend. Edge traduce esto a la carga útil de SOAP que espera el servicio.
• El tipo de proxy proxy de paso permite que los clientes simplemente pasen una carga útil de SOAP. Esta es una forma de que las llamadas al servicio de SOAP se beneficien de las funciones de administración de Edge.

Prueba el proxy

Para probar el proxy que creaste, abre un símbolo del sistema y usa cURL. Escribe el siguiente comando donde:

• ORG es el nombre de la organización de Edge en la que creaste el proxy.
• ENV es el entorno en el que se implementa el proxy.
• DOMAIN corresponde a la instancia de Edge que usas.

curl "https://{ORG}-{ENV}.{DOMAIN}/delayedstockquote/quote?StockSymbol=GOOG&LicenseKey=0"

Por ejemplo, si tu organización es docfood, el entorno es test, y usas la nube empresarial de Edge, ejecutarías un comando como este:

curl "https://docfood-test.apigee.net/delayedstockquote/quote?StockSymbol=GOOG&LicenseKey=0"

Si ingresaste GOOG para el parámetro de consulta StockSymbol, deberías obtener el precio actual de las acciones de clase C de Alphabet Inc. Por ejemplo:

{  
   "GetQuoteResponse":{  
      "GetQuoteResult":{  
         "StockSymbol":"GOOG",
         "LastTradeAmount":819.55,
         "LastTradeDateTime":"2017-02-13T14:33:00",
         "StockChange":5.88,
         "OpenAmount":816.0,
         "DayHigh":820.96,
         "DayLow":815.49,
         "StockVolume":785064,
         "PrevCls":813.67,
         "ChangePercent":"+0.72%",
         "FiftyTwoWeekRange":"663.28 - 841.95",
         "EarnPerShare":27.88,
         "PE":29.4,
         "CompanyName":"Alphabet Inc.",
         "QuoteError":false
      }
   }
}

Obtén la especificación de OpenAPI generada automáticamente

Cuando agregas un proxy de un servicio de SOAP con "REST a SOAP a REST", Edge genera automáticamente una especificación de OpenAPI. Puedes usar la especificación de OpenAPI para generar documentación de la API.

Para obtener la especificación de OpenAPI, visita esta URL:

curl https://{ORG}-{ENV}.{DOMAIN}/delayedstockquote/openapi.json

Crédito adicional: ¿Cómo descubres qué recurso, verbo y parámetros de consulta usar?

En la llamada a la API de prueba, usaste un recurso y parámetros de consulta específicos en tu llamada a cURL al servicio de SOAP de backend. Pero ¿cómo lo averiguarías por tu cuenta?

Recurso y verbo

En el asistente de proxy de API, cuando creabas el proxy, viste cómo las operaciones de SOAP se asignarían a los verbos y recursos de la API. Sin embargo, si no los escribiste, aquí te mostramos cómo averiguarlo después de crear el proxy.

En la pestaña Desarrollar del proxy de API, en el panel Navegador de la izquierda, verás una lista de flujos en los extremos de proxy. Haz clic en el flujo que te interesa. Por ejemplo, el flujo GetQuote es una buena opción. Luego, consulta el XML en el panel de código, que muestra la ruta de acceso y el verbo del recurso para el flujo en el elemento <Condition>: /quote y GET.

Parámetros de consulta

Con el flujo GetQuote seleccionado, haz clic en la primera política en la vista de flujo gráfico. Debe ser una política de extracción de variables que capture los parámetros de consulta que se espera que se pasen: StockSymbol y LicenseKey. (Si realizas una búsqueda web del servicio de SOAP, te indica qué pasar para LicenseKey).

Los parámetros de consulta capturados se guardan como variables y la siguiente política los usa para construir el mensaje de SOAP.