Ir al contenido principal

Realizar peticiones API a sistemas de terceros

Atención, los nodos de proceso requieren conocimiento técnico sobre API's o Webservices, JSON, XML y otros conceptos relacionados con la comunicación entre sistemas informáticos.

Un nodo de proceso permite realizar una solicitud que se realizará a una API externa con el propósito de enviar o recibir información. Los parámetros para esta solicitud ya están definidos (como campos) a lo largo de nuestro flujo.

En este ejemplo, vamos a hacer unas 3 entradas: una de divisa de mi moneda, un valor numérico y la salida de mi divisa, por ejemplo, COP => USD, haciendo el llamado a una API pública para cambio de divisa.

Primero debemos definir nuestras entradas en el flujo conectado a un proceso que enviará las variables tomadas. Nombre de las variables de entrada (mi_divisa, cantidad, divisa_nombre_convertir)

image.png

Abre la configuración, haz clic en "Consumo de servicio web" y modifica los datos.

image.png

El campo Identificador nos sirve para poder solicitar los datos del salida de la petición en este caso es una solicitud de tipo GET.

El campo URL a consumir permite configurar la dirección a la cual se realizará la petición de el servicio. Puedes usar reemplazo de variables para las URL.


Configuración de envío

Esta configuración nos sirve por si nuestra petición necesita un token o un heder especifico para funcionar lo primero sería ingresar a configuración de envió.

image.png



¿Cómo enviar datos en la petición?

Para enviar datos en nuestra petición, procedemos a colocar el String (JSON o XML, etc). Puedes hacer uso de reemplazo de variables. Estas deben estar definidas en nuestro flujo. Las variables las podemos observar en la parte inferior de nuestro panel.

image.png


¿Cómo utilizar variables de la salida de un proceso?

Lo primero que tenemos que tener en cuenta es el nombre el cual tenemos de identificador nuestro proceso.

image.png


Según como sea la respuesta del consumo, el sistema automáticamente realizará un aplanamiento de variables (convertir arrays multidimensionales en una sola dimensión por medio de puntos "."). 

Por ejemplo: image.png

Para utilizar el resultado de esta petición (ver imagen superior) el valor aplanado sería {{conversion.result.amount}}. Esta variable podemos utilizarla después en nuestro flujo.