Especificaciones para el uso del recurso web denominado Positions que ofrece la aplicación www.monit.mx vía API REST.
Observación importante
Se expresa constancia de que el recurso web que aquí se documenta pertenece a
las soluciones de Diseño Electronico de Circuitos Aplicados, SA de CV, quien se reserva el derecho de modificarlo según lo considere necesario. Quienes utilizan esta interfaz reconocen que ante cualquier cambio deberán ajustar sus productos o herramientas según lo requiera, sin ningún tipo de reclamo o perjuicio para Diseño Electronico de Circuitos Aplicados, SA de CV.
Objetivo del documento
El objetivo del presente documento es detallar las especificaciones técnicas sobre uso del recurso web Positions para la recuperación de reportes de posición de unidades/gps.
Descripción del recurso web Positions
Este recurso ofrece una interfaz para la recuperación de la posición actual de una lista de vehículos previamente registrada en la plataforma Monit.
Pre requisitos para el uso de la interfaz
- Cuenta en monit.pro: Contar con una cuenta como cliente en la aplicación www.monit.mx para lo cual podrá acudir directamente a nuestras oficinas ubicadas en Monclova #1555 Fracc. República Pte., ****ponerse en contacto mediante los teléfonos +52 (844) 415-1610 y +52 (800) 831 2527 o enviando un correo electrónico a [email protected]
- Alta de equipos Gps/unidades: Luego de haber sido registrado como cliente y de tener las credenciales de acceso, también debe de haber dado de alta los equipos de rastreo en Monit
- Frecuencia de consulta: acordar con la parte integradora la frecuencia con que va a consultar la información de Position
- Crear Integración: deberá crear (en Monit) lo que se considera una “integración para un web service“ , lo cual puede consultar aquí y para lo cual necesita la frecuencia mencionada en el punto anterior. Esta acción generará una API Key que se deberá entregar a la parte que realizará el consumo del servicio para la autenticación de cada consulta que realice al recurso.
- Relacionar unidades/GPS: Teniendo lista la integración, debe relacionarle la lista de unidades/gps que serán objeto de esta consulta, ya que por cada consulta, Positions solo devolverá la información de la posición actual de unidades/gps de esta lista. La misma (la lista) podrá ser actualizada en el tiempo tantas veces como sea necesario. Para saber cómo hacer esta relación de la lista de unidades/gps con la integración recién registrada, haga clic aquí sin olvidar revisar el apartado específico para Positions.
- Activar integración: Para que el recurso pueda ser consumido deberá activar la integración en Monit de lo contrario se recibirá un mensaje de error de credenciales no proveidas.
INTEGRACIÓN: es un registro que se crea en Monit para que un tercero pueda consumir el recurso web Position, a este registro se encuentra asociada un API Key para la autenticación de las consultas y la lista de vehículos de interés. Este registro puede o no estar activo y la lista de vehículos asociada al mismo puede ser actualizada en cualquier momento por un usuario de Monit .
Los requisitos técnicos para la integración con este recurso los puede consultar en esta sección: Manual Integrador de Position