Especificaciones para el uso del recurso web denominado Positions que ofrece la aplicación www.monit.pro 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 el 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

• Acordar con el cliente de Monit la frecuencia con que realizará las consultas de posición.
• Solicitar Api Key para autenticación ****(Esta clave es generada dentro de la plataforma Monit, debe solicitarla a su cliente Monit, se usará para la autenticación de cada consulta que se haga a Positions)
• Solicitar el identificador de empresa en Monit. (Este dato debe ser del conocimiento de la empresa cliente de Monit que requiere el monitoreo de las unidades y se usará para conformar la url para la consulta de posiciones)
• INTEGRACIÓN activada en la plataforma Monit (Si el recurso web le notifica invariablemente que las credenciales no fueron proveídas y esto último ya ha sido descartado, favor de asegurarse que la integración registrada para su cliente en la plataforma Monit se encuentra activa, esto lo debe hacer el cliente de Monit dentro de la plataforma Monit)
• Lista de unidades/GPS objeto de consulta previamente dadas de alta en monit y relacionadas a la INTEGRACIÓN correspondiente.

INTEGRACIÓN: es un registro que se crea en Monit para que un tercero pueda consumir el recurso web Positions, a este registro se encuentra asociada el 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

Uso del recurso web Positions

Para el uso de Positions se debe elaborar un programa que mediante la realización periódica de peticiones, usando el método GET, solicite la información de la posición actual de los vehículos de interés.

<aside> ℹ️ URL para las peticiones usando método GET https://<<id_empresa>>.api.monit.ws/api/web-service/position/

</aside>

<aside> ℹ️ Para la autenticación usar la cabecera key: Authorization value: Api-Key <<el valor del Api Key>>

</aside>