Creación de solicitudes para la API Planning
Antes de empezar 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'
Se enviarán al body todos los parámetros para resolver el problema logístico.
La Planning API funciona de forma asíncrona. En otras palabras, se devolverá un ID cuando se envíe el problema. Con este ID puede comprobar la respuesta en el futuro o el estado de tramitación.
La API dispone de los siguientes endpoints, en los que el término {planningId} debe sustituirse por el ID del problema que se desea consultar:
- https://api.maplink.global/planning/v1/problems – POST
Se utiliza para enviar el problema logístico. Se devolverá un ID para la consulta. - https://api.maplink.global/planning/v1/events?jobId={{planningId}} – GET
Devuelve todos los estados desde la recepción de la solicitud hasta su finalización. - https://api.maplink.global/planning/v1/jobs/{{planningId}} – GET
Devuelve el estado actual de procesamiento de la solicitud. - https://api.maplink.global/planning/v1/solutions/{{planningId}} – GET
Devuelve el resultado de la planificación logística.
Nota: Los ID de solución pueden consultarse durante un periodo de 7 días.