Creación de solicitudes para la Trip API
Antes de comenzar a utilizar la API, deberá obtener el token de autenticación.
Se requerirán las siguientes headers, donde la palabra token debe sustituirse por el token obtenido en el proceso de autenticación:
--header 'Content-Type: application/json' \ --header 'Authorization: Bearer token'
En el body se enviarán todos los parámetros para resolver el cálculo de la ruta.
La Trip API puede funcionar de dos maneras, de forma sincrónica o asincrónica.
Trip Sincrónica
Con Trip sincrónica es posible obtener el resultado del enrutamiento en una sola solicitud. La Trip Sincrónica tiene los siguientes endpoints, donde el término {{tripId}} debe sustituirse por el ID de la ruta que se desea consultar:
- https://api.maplink.global/trip/v2/calculations – POST
Se utiliza para enviar el problema logístico. Se devuelve el resultado completo de la secuencia de comandos. - https://api.maplink.global/trip/v1/solutions/{{tripId}} – GET
Devuelve el resultado del enrutamiento según el ID introducido. Para que no tenga que volver a enviar la solicitud, puede utilizar el ID de ruta que utilizó anteriormente para la consulta.
Las coordenadas de la ruta en Trip Sincrónica se devolverán en el formato polyline para un mejor rendimiento.
Trip Asíncrona
A diferencia de la Trip Sincrónica, al enviar una solicitud al Trip Asíncrona sólo se devolverá el ID de ruta para futuras consultas. También cuenta con dos endpoints adicionales que permiten comprobar el estado de procesamiento de las solicitudes.
Trip Asíncrona tiene los siguientes endpoints, donde el término {{tripId}} debe ser sustituido por el ID de la ruta a consultar:
- https://api.maplink.global/trip/v1/problems – POST
Se utiliza para enviar la ruta a enrutar. Se devolverá un ID para la consulta. - https://api.maplink.global/trip/v1/events?jobId={{tripId}}– GET
Devuelve todos los estados desde la recepción de la solicitud hasta su finalización. - https://api.maplink.global/trip/v1/jobs/{{tripId}} – GET
Devuelve el estado actual de procesamiento de la solicitud. - https://api.maplink.global/trip/v1/solutions/{{tripId}} – GET
Devuelve el resultado del enrutamiento.
Las coordenadas de la ruta en Trip Asíncrona se devolverán en forma de un objeto.
Nota: Las identificaciones de ruta pueden consultarse durante un periodo de 7 días. Si necesita que su ruta se almacene durante más tiempo, consulte Route Storage para obtener más información.
