Introducción
API Endpoint
https://apirest.logictracker.com/
La API de LOGICTRACKER proporciona acceso programático para leer y actualizar datos de sus principales entidades de negocio.
Para utilizar nuestra API, el cliente necesitará 2 datos fundamentales: IdEmpresa y HashApi . Contáctenos en soporte@logictracker.com para obtener sus credenciales y comenzar a utilizar nuestra API.
Get events
# Ejemplo Request HTTP
POST /api/events/getEventsByCompany HTTP/1.1
Host: apirest.logictracker.com
Content-Type: application/json
{
"IdEmpresa": TU_ID_EMPRESA,
"HashApi": "TU_HASH_API",
"Patente": "AA568LH",
"FechaDesde": "15/02/2023 16:50:00",
"FechaHasta": "15/02/2023 17:50:00"
}
# Ejemplo Request CURL
curl --location --request POST 'https://apirest.logictracker.com/api/events/getEventsByCompany' \
--header 'Content-Type: application/json' \
--data-raw '{
"IdEmpresa": TU_ID_EMPRESA,
"HashApi": "TU_HASH_API",
"Patente": "AA568LH",
"FechaDesde": "15/02/2023 16:50:00",
"FechaHasta": "15/02/2023 17:50:00"
}'
Para obtener el listado de eventos de la patente, debe realizar una llamada POST a la siguiente URL:
https://apirest.logictracker.com/api/events/getEventsByCompany
# Ejemplo API Respuesta
{
"genericResponse": {
"codigo": 200,
"mensaje": "OK",
"id": 0
},
"events": [
{
"codigo": "100",
"mensajeDescripcion": "Detención",
"latitud": -38.694160461425781,
"longitud": -62.327587127685547,
"descripcion": "Detención Bahía Blanca, Buenos Aires, Argentina - Duración: 00:01:00",
"fechaHoraGeneracion": "2023-08-07T13:50:00",
"fechaHoraRecepcion": "2023-08-07T13:59:43",
"patente": "AA568LH",
"interno": "AA568LH"
},
{
"codigo": "920",
"mensajeDescripcion": "GeoCerca Salida",
"latitud": -38.695758819580078,
"longitud": -62.328189849853516,
"descripcion": "GeoCerca Salida Base ANJOR Bahía Blanca",
"fechaHoraGeneracion": "2023-08-07T13:52:00",
"fechaHoraRecepcion": "2023-08-07T13:59:43",
"patente": "AA568LH",
"interno": "AA568LH"
},
{
"codigo": "910",
"mensajeDescripcion": "GeoCerca Entrada",
"latitud": -38.74237060546875,
"longitud": -62.295860290527344,
"descripcion": "GeoCerca Entrada Control de CheckList Bahia",
"fechaHoraGeneracion": "2023-08-07T14:03:00",
"fechaHoraRecepcion": "2023-08-07T14:07:19",
"patente": "AA568LH",
"interno": "AA568LH"
},
{
"codigo": "910",
"mensajeDescripcion": "GeoCerca Entrada",
"latitud": -38.74237060546875,
"longitud": -62.295860290527344,
"descripcion": "GeoCerca Entrada Refineria Bahía Blanca",
"fechaHoraGeneracion": "2023-08-07T14:03:00",
"fechaHoraRecepcion": "2023-08-07T14:07:19",
"patente": "AA568LH",
"interno": "AA568LH"
},
{
"codigo": "910",
"mensajeDescripcion": "GeoCerca Entrada",
"latitud": -38.74237060546875,
"longitud": -62.295860290527344,
"descripcion": "GeoCerca Entrada Bahía Blanca",
"fechaHoraGeneracion": "2023-08-07T14:03:00",
"fechaHoraRecepcion": "2023-08-07T14:07:19",
"patente": "AA568LH",
"interno": "AA568LH"
},
{
"codigo": "100",
"mensajeDescripcion": "Detención",
"latitud": -38.743457794189453,
"longitud": -62.295749664306641,
"descripcion": "Detención Av. Colón 2771, Bahía Blanca, Buenos Aires, Argentina - Duración: 00:01:00",
"fechaHoraGeneracion": "2023-08-07T14:17:00",
"fechaHoraRecepcion": "2023-08-07T14:24:07",
"patente": "AA568LH",
"interno": "AA568LH"
}
]
}
REQUEST BODY PARAMETERS
| Nombre |
Tipo |
Descripción |
| IdEmpresa |
Int |
Será un ID único provisto por Logictracker para el cliente que consulta la API. |
| HashApi |
String |
Será un HASH único provisto por Logictracker para el cliente que consulta la API. |
| Patente |
String |
Patente del vehiculo que registró las eventos. |
| FechaDesde |
String |
Fecha y hora DESDE del periodo en el que busco eventos. Formato: dia/mes/año hora:minutos:segundos. |
| FechaHasta |
String |
Fecha y hora HASTA del periodo en el que busco eventos. Formato: dia/mes/año hora:minutos:segundos. |
RESPONSE PARAMETERS
| Nombre |
Tipo |
Descripción |
| response |
GenericResponse |
Objeto que indica una respuesta generica de la API. |
| events |
List<events> |
Lista de eventos registradas. |
GENERIC RESPONSE PARAMETERS
| Nombre |
Tipo |
Descripción |
| codigo |
Int |
Código respuesta de la API. |
| mensaje |
String |
Mensaje que describe la respuesta de la API. |
| id |
Int |
En caso de generar el alta de una entidad, la API puede devolver el ID de la entidad creada. |
events PARAMETERS
| Nombre |
Tipo |
Descripción |
| codigo |
string |
Codigo del evento. |
| mensaje |
string |
Mensaje del evento. |
| longitud |
Float |
Longitud del evento registrado. |
| longitud |
Float |
Latitud del evento registrado. |
| velocidad |
Int |
Velocidad de la posición registrada. |
| descripcion |
String |
Descripcion del evento registrado. |
| fechaHoraGeneracion |
String |
Fecha y hora en que se generó el evento. Formato: dia/mes/año hora:minutos:segundos. |
| fechaHoraRecepcion |
String |
Fecha y hora en que se recepcionó el evento. Formato: dia/mes/año hora:minutos:segundos. |
| patente |
String |
Patente del vehiculo que generó el evento. |
| interno |
String |
Interno del vehiculo que generó el evento. |
Errors
La llama a la API de events/getEventsByCompany puede devolver los siguientes códigos de error dentro del objeto GenericResponse
| Código |
Mensaje |
| 200 |
OK
|
| 400 |
Request sin contenido en body, body request null.
|
| 401 |
Consulta sin id de empresa/hash. Asegurese de incluir en su request idEmpresa y hashApi provisto por LOGICTRACKER.
|
| 402 |
Empresa no habilitada para consultar Get events. Solicitar habilitación uso de API a LOGICTRACKER.
|
| 403 |
Hash invalido para consultar API. Asegurese que hashApi provisto por LOGICTRACKER sea el correcto.
|
| 404 |
La consulta no puede superar las horas configuradas en la empresa.
|
| 405 |
La consulta supera el máximo histórico permitido.
|
| 406 |
No se encuentran vehiculos para la consulta
|
| 500 |
Excepcion en api/events/getEventsByCompany. Entre en contacto con el area de sistemas de LOGICTRACKER y envie el CONTENIDO DEL REQUEST para ser analizado.
|
