Integraciones manuales

Independiente al Mercado de apps, que conecta tu negocio con Instituciones como Buró de crédito o ¿Quién es quién?, Kosmos te permite integrar tu propio código y listas con otros servicios Web a través de las integraciones manuales.

En el Dashboard de integraciones manuales encontrarás listadas tus integraciones, además puedes dividirlas entre Rest y Soap.

Soap

Se basa en una estructura de datos XML. Tiene un esquema de "árbol" construido por llaves que contienen atributos.

Rest

Se basa en una estructura de datos Json. Es más sencillo de consumir e interpretar. No tiene un esquema de árbol, sino de corchetes {} que contienen la información dentro de la misma estructura.

Es importante conocer la diferencia entre ambas para configurar tu integración manual.


Para iniciar haz click en "Agregar integración" y verás una pantalla como esta.

Arriba verás una lista horizontal que contiene

1 Configura tu servicio

2 Prueba tu servicio

3 Funciones de parseo

Son las "fases" para configurar tu integración manual

Configura tu servicio

En configura tu servicio encontrarás tres opciones; Detalles, Parámetros de entrada y Configuración.

Haz click en "Ver más" para desplegar

Detalles

Selecciona el tipo de servicio que vas a utilizar. Rest o Soap.

Nombra tu integración y descríbela brevemente.

Parámetros de entrada

Este apartado es completamente opcional. Sirve para información que capturas a través de formularios en tu flujo.

Para este ejemplo, vamos a crear un parámetro llamado "Parámetro Kosmos Academy"

En tipo de parámetro tienes diferentes opciones que dependen de la información  de tus flujos:

Configuración

A continuación vamos a configurar.

Endpoint: Es la URL con la que vas completar tu servicio. En este ejemplo será kosmos.la/academy.

Timeout: Es el tiempo límite, medido en segundos, para esperar la respuesta.

Método HTTP: Es el tipo de petición que vamos a hacer a nuestro endpoint.

Tipo de respuesta: Seleccionamos si queremos vamos a recibir un JSON, XML o un texto.

Ver métodos HTTP

GET: Sólo se recuperan los datos.

POST: A diferencia de GET, no recupera datos, sino que crea datos.

PUT: Actualiza los datos, pero no los crea, es decir, no puede crear un dato si no existe.

DELETE: Elimina un dato.

HEAD: Parecido a GET, pero recupera datos sólo del encabezado, omite el resto de la página.

PATCH: Modifica/Corrige parcialmente un dato.

Prueba tu servicio

Aquí vamos a poner a prueba el Endpoint que colocamos previamente.

Lo primero que veremos será una pestaña de parámetros. Donde encontrarás parámetros previamente creados. También puedes agregar más.

Haz click en el botón "Probar".

Verás un mensaje que indica que la prueba funcionó correctamente.

Verás una respuesta con dos pestañas. "Headers" y "Body".

También verás tres datos que te indican: 

Estatus de la respuesta: Indica si se encontró correctamente.

Tiempo: Lapso que tardó en tener una respuesta

Tamaño: Peso de la solicitud.

Funciones de Parseo

Primero, ¿Qué es el parseo?

En términos simples, se puede definir como el análisis de información de un texto para extraer sus datos. En otras palabras, de cada resultado web que obtenemos, qué información vamos a necesitar.


Encontraremos tres pestañas:

Función

En "Función" encontrarás el código y la opción (marcada en color verde) para editar tu propio código.

Test

En "Test" encontrarás la respuesta (en código) del servicio web que solicitaste (endpoint). Aquí están todas las variables que contiene. 

En este caso tenemos "type" subrayada en rojo porque la usaremos más adelante.

Resultado

De inicio, el "Resultado" aparece en blanco porque aún no hemos ejecutado.

En "Función" puedes escribir tu código acorde a lo que deseas hacer.

En este ejemplo, de toda la respuesta que tenemos obtuvimos en "Test" únicamente queremos la variable "type"

simpleVariaples.set indica que queremos una variable

Entre comillas designamos la variable, en este caso types.

Después, .get indica que del json que obtenemos por respuesta, queremos extraer el dato "types".

Te dejamos este código para copiar y pegar para casos donde necesites una variable, sólo necesitas reemplazar según tu integración manual.

simpleVariables.set("tu_variable", _json.get("tu_variable"));

Después de colocar tu código, haz click en "Ejecutar".

Si la ejecución no falla, verás un mensaje en letras rojas indicando el error. Se te indicará en dónde está el fallo de la ejecución para corregirlo.


Si la ejecución es exitosa, la pestaña de resultados te arrojará el código donde extrae la variable que indicaste, en este ejemplo es "types".


Ahora sólo haz click en "Finalizar" para guardar la integración.

¡Listo!

Verás tu integración guardada en la lista de integraciones manuales y ahora está disponible para usarla en tu lógica de negocio con el nodo de integraciones.