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 positions
# Ejemplo Request HTTP
POST /api/positions/getPositionsByVehicles HTTP/1.1
Host: apirest.logictracker.com
Content-Type: application/json
{
"IdEmpresa": TU_ID_EMPRESA,
"HashApi": "TU_HASH_API",
"Patentes": "Patentes": [
"AD037RM",
"AB677VL"
],
"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/positions/getpositionsByVehicles' \
--header 'Content-Type: application/json' \
--data-raw '{
"IdEmpresa": TU_ID_EMPRESA,
"HashApi": "TU_HASH_API",
"Patentes": "Patentes": [
"AD037RM",
"AB677VL"
],
"FechaDesde": "15/02/2023 16:50:00",
"FechaHasta": "15/02/2023 17:50:00"
}'
Para obtener el listado de posiciones de las patentes, debe realizar una llamada POST a la siguiente URL:
https://apirest.logictracker.com/api/positions/getPositionsByVehicles
# Ejemplo API Respuesta
{
"genericResponse": {
"codigo": 200,
"mensaje": "OK",
"id": 0
},
"positions": [
{
"latitud": -38.720298767089844,
"longitud": -62.313678741455078,
"velocidad": 0,
"curso": 315.00787353515625,
"estadoMotor": null,
"fechaHora": "2023-01-23T00:56:29",
"fechaHoraRecepcion": "2023-01-23T00:56:25",
"hdop": 0.0,
"patente": "AD037RM"
},
{
"latitud": -38.720298767089844,
"longitud": -62.313678741455078,
"velocidad": 10,
"curso": 315.00787353515625,
"estadoMotor": null,
"fechaHora": "2023-01-23T00:59:29",
"fechaHoraRecepcion": "2023-01-23T00:59:25",
"hdop": 0.0,
"patente": "AB677VL"
}
]
}
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. |
| Patentes |
List<string> |
Patentes de los vehiculos que quiero buscar. |
| FechaDesde |
String |
Fecha y hora DESDE del periodo en el que busco posiciones. Formato: dia/mes/año hora:minutos:segundos. |
| FechaHasta |
String |
Fecha y hora HASTA del periodo en el que busco posiciones. 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. |
| positions |
List<Positions> |
Lista de posiciones 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. |
Positions PARAMETERS
| Nombre |
Tipo |
Descripción |
| longitud |
Float |
Longitud de la posición registrada. |
| latitud |
Float |
Latitud de la posición registrada. |
| velocidad |
Int |
Velocidad de la posición registrada. |
| curso |
Int |
Curso de la posición. |
| estadoMotor |
bool? |
Puede ser true / false / null. True: encendido / False: apagado / Null: sin información. |
| FechaHora |
String |
Fecha y hora en que se generó la posición. Formato: dia/mes/año hora:minutos:segundos. |
| fechaHoraRecepcion |
String |
Fecha y hora en que se recepcionó la posición. Formato: dia/mes/año hora:minutos:segundos. |
| hdop |
Float |
Calidad hdop de la posición. |
| patente |
String |
Patente del vehiculo que generó la posición. |
Errors
La llama a la API de positions/getPositionsByVehicles 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 positions. Solicitar habilitación uso de API a LOGICTRACKER.
|
| 403 |
Hash invalido para consultar API. Asegurese que hashApi provisto por LOGICTRACKER sea el correcto.
|
| 404 |
Fecha desde nula.
|
| 405 |
Fecha hasta nula.
|
| 406 |
Sin patentes.
|
| 407 |
Rango de consulta maximo 1 día.
|
| 500 |
Excepcion en api/positions/getPositionsByVehicles. Entre en contacto con el area de sistemas de LOGICTRACKER y envie el CONTENIDO DEL REQUEST para ser analizado.
|