| Tabla de contenidos | ||||
|---|---|---|---|---|
|
...
| Nota |
|---|
Todos los servicios ejecutados, deben incluir el siguiente header: Nombre del Header: Valor a enviar: Ejemplo: Se deben enviar las IP’s desde las cuales recibiremos los llamados a nuestras APIs, pues se deben incluir en una whitelist. Si el llamado no cumple con el header o se hace desde una IP diferente a las autorizadas, el request no se va a procesar. |
1. GuestSession [GET]
Este servicio retorna un token de sesión necesario para ejecutar los siguientes servicios. Se debe realizar la autenticación sobre el ambiente que se desee utilizar. Dicho token de session, tiene una validez de 24 horas, por ende, con un solo token se pueden realizar las busquedas necesarias durante ese lapso de tiempo, posterior a ello, se debe generar un nuevo token.
...
Ejemplo de Respuesta:
...
2. Air MetaSearch [POST]
Por medio de este servicio se lanza la búsqueda, con los destinos, fechas, cantidad de pasajeros que se requieran, este flujo permite que para la búsqueda en especifico que se esta realizando, se muestren cada una de las opciones de aéreo con un deeplink (Es un parametro que contiene una URL que redirecciona a un producto seleccionado).
...
Donde la variable {SessionToken} debe ser reemplazada por el token de sesión, obtenido en el paso 1.
Ejemplo de Respuesta:
...
3. AirResults (Opcional) [POST]
Por medio de este servicio se pueden ordenar los resultados, paginar e incluso aplicar filtros, tales como; devolver opciones de aerolíneas en concreto, tipos de trayecto directo o con escala, con equipaje, por duración del vuelo, entre otros.
Consideraciones generales
Por medio de los parámetros "ResultCountLowerBound" y "ResultCountUpperBound" se pueden pedir los resultados en determinadas cantidades para hacer en el portal web una paginación, ejemplo
Primer llamado del servicio, con los siguientes parametros:
"ResultCountLowerBound": 0,
"ResultCountUpperBound": 10,
Resultado: La respuesta incluira los 10 primeros resultados unicamente.
Segundo llamado del servicio, con los siguientes parametros:
"ResultCountLowerBound": 11,
"ResultCountUpperBound": 21,
Resultado: La respuesta incluira 10 resultados entre el 11 y 21.
En este caso por ejemplo el portal web, podra presentar 10 resultados en la pagina 1 y los siguientes 10 resultados en la pagina 2.
Curl de Ejemplo:
| Bloque de código |
|---|
curl --location 'https://certificacion.netactica.com/netcoreapi/AirResultsV2' \
--header 'x-net-metasearch: demo-metaprueba' \
--data '{
"SearchId": "{SearchID}",
"OrderDesc": true,
"OrderCriteria": "RECOMENDATION",
"ResultCountLowerBound": 0,
"ResultCountUpperBound": 2100000,
"SessionToken": "{SessionToken}"
}
' |
Donde la variable {SessionToken} debe ser reemplazada por el token de sesión, obtenido en el paso 1 y la variable {SearchID} representa el id unico de la busqueda realizada, este parametro se obtiene en el paso 2, en la respuesta del servicio AirMetaSearch.
Ejemplo de Respuesta:
4. Redirección al Deeplink
La redirección del cliente al deeplink generado en la respuesta del servicio AirMetaSearch, para la opción seleccionada por el cliente, permitira que se redirija al mismo al flujo de venta de la agencia.
Diagrama de flujo
...
