Usa un proxy para un servicio de SOAP

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

En este instructivo, se ilustra cómo generar una nueva API de RESTful por delante de tus bases de datos basadas en SOAP. servicio. Aunque no se describe en detalle aquí, también puedes generar un proxy de transferencia que acepta una carga útil de SOAP y la pasa al servicio de backend.

Requisitos

• Una cuenta de Apigee Edge Si aún no tienes una, puedes registrarte con las instrucciones sobre cómo llegar. en Cómo crear un entorno de Cuenta de 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 RESTful con una traducción. a SOAP. Los clientes lo llaman como lo harían con otros servicios RESTful y pasan la consulta que necesita el servicio de backend. Edge lo traduce en la carga útil de SOAP que espera el servicio.
• El tipo de proxy de proxy de transferencia permite a los clientes pasar una carga útil de SOAP. Esta es una forma de hacer que las llamadas de 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 comando a continuación, 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.
• DOMINIO corresponde a la instancia de Edge que estás usando.

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

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

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 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 OpenAPI generada automáticamente Especificación

Cuando se usa un proxy en un servicio de SOAP con “REST a SOAP a REST”, Edge genera automáticamente una especificación de OpenAPI. Puedes usar la Especificaciones de OpenAPI para generar documentación de la API para la API.

Para obtener las especificaciones de OpenAPI, visita esta URL:

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

Crédito adicional: Cómo averigua qué parámetros de recursos, verbos y consultas usar?

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

Recurso y verbo

En el asistente del proxy de API, cuando creó el proxy, vio cómo las operaciones de SOAP se asignarían a verbos y recursos de API. Pero si no los anotara, así es como los descubrirás después de crearlo.

En la pestaña Develop del proxy de API, en el panel de navegación izquierdo, verás un una lista de flujos en los extremos del proxy. Haz clic en el flujo que te interesa. Por ejemplo: el flujo de GetQuote es un buen candidato. Luego, mira el XML en el panel Code que muestra la ruta del recurso y el verbo para el flujo en la columna <Condition> elemento: /quote y GET.

Parámetros de consulta

Con el flujo GetQuote seleccionado, haga clic en la primera política del gráfico. de flujo de VPC. Debe ser una política de extracción de variables que capture los parámetros de consulta que se se espera que se pase: StockSymbol y LicenseKey. (Si realizas una campaña busca el servicio SOAP, te indica qué debes pasar por LicenseKey).

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