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/GetPositions HTTP/1.1
Host: apirest.logictracker.com
Content-Type: application/json
{
"IdEmpresa": TU_ID_EMPRESA,
"HashApi": "TU_HASH_API",
"FechaDesde":"12/11/2020 10:00:00",
"FechaHasta":"13/11/2020 09:59:00",
"Patente":"AB123CD"
}
# Ejemplo Request CURL
curl --location --request POST 'https://apirest.logictracker.com/api/Positions/GetPositions' \
--header 'Content-Type: application/json' \
--data-raw '{
"IdEmpresa": TU_ID_EMPRESA,
"HashApi": "TU_HASH_API",
"FechaDesde":"12/11/2020 10:00:00",
"FechaHasta":"13/11/2020 09:59:00",
"Patente":"AB123CD"
}'
Para obtener el listado de posiciones de la patente, debe realizar una llamada POST a la siguiente URL:
https://apirest.logictracker.com/api/Positions/GetPositions
# Ejemplo API Respuesta
{
"response": {
"codigo": 200,
"mensaje": "OK",
"id": 0
},
"positions": [
{
"latitud": -34.592140197753906,
"longitud": -58.467117309570312,
"velocidad": 0,
"curso": 120.00787353515625,
"estadoMotor": null,
"fechaHora": "2020-11-12T11:12:31"
},
{
"latitud": -34.589408874511719,
"longitud": -58.468219757080078,
"velocidad": 15,
"curso": 315.00787353515625,
"estadoMotor": null,
"fechaHora": "2020-11-12T12:06:49"
},
{
"latitud": -34.588775634765625,
"longitud": -58.469051361083984,
"velocidad": 0,
"curso": 120.00787353515625,
"estadoMotor": null,
"fechaHora": "2020-11-12T12:07:12"
},
{
"latitud": -34.5880241394043,
"longitud": -58.4699821472168,
"velocidad": 19,
"curso": 328.00787353515625,
"estadoMotor": null,
"fechaHora": "2020-11-12T12:07:36"
},
{
"latitud": -34.586940765380859,
"longitud": -58.471031188964844,
"velocidad": 11,
"curso": 348.00787353515625,
"estadoMotor": null,
"fechaHora": "2020-11-12T12:08:01"
}
]
}
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. |
| 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. |
| Patente |
String |
Patente del vehiculo que registró las posiciones. |
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 |
| latitud |
Float |
Latitud de la posición registrada. |
| longitud |
Float |
Latitud de la posición registrada. |
| velocidad |
Int |
Velocidad de la posición registrada. |
| estadoMotor |
String |
Encendido / Apagado. |
| fechaHora |
String |
Fecha y hora de la posición registrada. Formato: dia/mes/año hora:minutos:segundos. |
Errors
La llama a la API de Positions/GetPositions 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 |
Patente nula.
|
| 407 |
Rango de consulta maximo 1 día.
|
| 408 |
No existe vehiculo.
|
| 500 |
Excepcion en api/Positions/GetPositions. Entre en contacto con el area de sistemas de LOGICTRACKER y envie el CONTENIDO DEL REQUEST para ser analizado.
|