API de Rastreo GPS | Documentación LIOT

rocket_launchIntroducción

La API de Rastreo LIOT es una API REST sobre HTTPS que entrega acceso programático a toda la información de tu flota: dispositivos, posiciones en tiempo real, historial de recorridos, eventos, geocercas, reportes y más. Está pensada para integraciones de empresas y partners que necesitan llevar la telemetría de LIOT a sus propios sistemas.

lightbulb

Formato de datos. Todas las respuestas son JSON (también se pueden exportar recorridos en CSV, KML y GPX). Las fechas usan formato ISO 8601 en UTC, por ejemplo 2026-01-01T18:30:00Z.

link

URL base

https://gps.liot.cl/api

bolt

WebSocket

wss://gps.liot.cl/api/socket

schedule

Disponibilidad

24/7, con monitoreo continuo y soporte dedicado.

verified_user

Seguridad

TLS obligatorio. Acceso autenticado por token o sesión.

Primeros pasos

Obtén tus credenciales de API (usuario y contraseña o un token de integración) escribiendo a soporte@liot.cl.
Genera un token de acceso o inicia sesión.
Consulta tus dispositivos y sus posiciones.
Para actualizaciones en vivo, conéctate al canal WebSocket.

keyAutenticación

La API admite tres mecanismos. Todos los endpoints marcados como “Requiere autenticación” responden 401 si no envías credenciales válidas.

Token de acceso Recomendado

Autenticación tipo Bearer. Ideal para integraciones y servidores.

Authorization: Bearer TU_TOKEN_DE_ACCESO

También puedes enviarlo como parámetro: ?token=TU_TOKEN

Sesión con cookie

Autenticación básica en el inicio de sesión; el servidor devuelve una cookie JSESSIONID que se reutiliza en las siguientes llamadas.

POST /session
Content-Type: application/x-www-form-urlencoded

email=usuario@empresa.cl&password=CLAVE

Basic Auth

Usuario y contraseña codificados en Base64, útil para scripts simples.

Authorization: Basic base64(usuario:contraseña)

Generar un token

curl -X POST "https://gps.liot.cl/api/session/token" \
  -u usuario@empresa.cl:CLAVE \
  -d "expiration=2027-01-01T00:00:00Z"

shield

Buenas prácticas. Usa siempre HTTPS, almacena los tokens en variables de entorno o gestores de secretos, y rótalos periódicamente. Nunca expongas credenciales en el frontend.

boltTiempo real (WebSocket)

En lugar de consultar repetidamente el endpoint de posiciones, conéctate al canal WebSocket para recibir actualizaciones apenas el equipo las reporta. Es la forma recomendada para mapas y paneles en vivo.

const socket = new WebSocket('wss://gps.liot.cl/api/socket');

socket.onmessage = (event) => {
  const data = JSON.parse(event.data);
  // data.positions -> últimas posiciones
  // data.events    -> eventos recientes
  console.log(data);
};

socket.onopen = () => socket.send(JSON.stringify({ devices: [1234] }));

info

La conexión WebSocket reutiliza la sesión autenticada (cookie). Primero inicia sesión con POST /session y luego abre el socket.

apiEndpoints

117 operaciones sobre 23 módulos. Usa el buscador de la barra lateral para encontrar un endpoint.

key

Sesión y autenticación

Inicia sesión, obtén tokens de acceso y gestiona la sesión activa.

GET/session#

Obtener información de la sesión

Público · sin autenticaciónkeySesión y autenticación

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`token`	query	string	no	—

Respuestas

200	OK
404	Not found

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/session"

POST/session#

Iniciar sesión

Público · sin autenticaciónkeySesión y autenticación

Cuerpo de la petición application/x-www-form-urlencoded

Esquema: object

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/session" \
  -d "email=usuario@empresa.cl" -d "password=CLAVE"

DELETE/session#

Cerrar la sesión

keyRequiere autenticaciónkeySesión y autenticación

Respuestas

204	No Content
401	Unauthorized

terminalEjemplo cURL

curl -X DELETE "https://gps.liot.cl/api/session" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

GET/session/{id}#

Abrir sesión como otro usuario

Solo administradores o gerentes. Abre una sesión suplantando al usuario indicado.

keyRequiere autenticaciónkeySesión y autenticación

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Respuestas

200	OK
401	Unauthorized
404	Not found

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/session/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

POST/session/token#

Generar token de acceso

keyRequiere autenticaciónkeySesión y autenticación

Cuerpo de la petición application/x-www-form-urlencoded

Esquema: object

Respuestas

200	Token string
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/session/token" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -d "campo=valor"

POST/session/token/revoke#

Revocar token de acceso

keyRequiere autenticaciónkeySesión y autenticación

Cuerpo de la petición application/x-www-form-urlencoded

Esquema: object

Respuestas

204	No Content
400	Bad request

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/session/token/revoke" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -d "token=TOKEN_DE_RESET" -d "password=NUEVA_CLAVE"

GET/session/openid/auth#

Iniciar autenticación OpenID Connect

keyRequiere autenticaciónkeySesión y autenticación

Respuestas

303	Redirect to OpenID Connect identity provider
400	OpenID Connect is not configured
default	Unexpected error

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/session/openid/auth" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

GET/session/openid/callback#

Callback de OpenID Connect

keyRequiere autenticaciónkeySesión y autenticación

Respuestas

303	Successful authentication, redirect to homepage
400	Invalid or expired callback parameters
default	Unexpected error

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/session/openid/callback" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

devices_other

Dispositivos

Alta, consulta, edición y baja de los equipos GPS de tu flota.

GET/devices#

Listar dispositivos

Sin parámetros, devuelve los dispositivos del usuario.

keyRequiere autenticacióndevices_otherDispositivos

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`all`	query	boolean	no	Solo administradores o gerentes pueden consultar todas las entidades.
`userId`	query	integer	no	Los usuarios estándar solo pueden usarlo con su propio `userId`.
`id`	query	integer	no	Para obtener uno o varios dispositivos. Se pueden pasar varios parámetros como `id=31&id=42`.
`uniqueId`	query	string	no	Para obtener uno o varios dispositivos. Se pueden pasar varios parámetros como `uniqueId=333331&uniqueId=44442`.
`excludeAttributes`	query	boolean	no	Excluye el campo de atributos de la respuesta.
`limit`	query	integer	no	Limita la cantidad de resultados devueltos.
`offset`	query	integer	no	Desplazamiento para paginación.
`keyword`	query	string	no	Filtro por palabra clave (busca en nombre, uniqueId, teléfono, modelo y contacto).

Respuestas

200	OK
400	No permission

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/devices" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

POST/devices#

Crear un dispositivo

keyRequiere autenticacióndevices_otherDispositivos

Cuerpo de la petición application/json

Esquema: Device

{
  "id": 0,
  "name": "",
  "uniqueId": "",
  "status": "",
  "disabled": false,
  "lastUpdate": "2026-01-01T00:00:00Z",
  "positionId": "",
  "groupId": "",
  "phone": "",
  "model": "",
  "contact": "",
  "category": "",
  "attributes": {}
}

Respuestas

200	OK
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/devices" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0,
    "name": "",
    "uniqueId": "",
    "status": "",
    "disabled": false,
    "lastUpdate": "2026-01-01T00:00:00Z",
    "positionId": "",
    "groupId": "",
    "phone": "",
    "model": "",
    "contact": "",
    "category": "",
    "attributes": {}
  }'

GET/devices/{id}#

Obtener un dispositivo

keyRequiere autenticacióndevices_otherDispositivos

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Respuestas

200	OK
401	Unauthorized
404	Not found

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/devices/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

PUT/devices/{id}#

Actualizar un dispositivo

keyRequiere autenticacióndevices_otherDispositivos

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Cuerpo de la petición application/json

Esquema: Device

{
  "id": 0,
  "name": "",
  "uniqueId": "",
  "status": "",
  "disabled": false,
  "lastUpdate": "2026-01-01T00:00:00Z",
  "positionId": "",
  "groupId": "",
  "phone": "",
  "model": "",
  "contact": "",
  "category": "",
  "attributes": {}
}

Respuestas

200	OK
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X PUT "https://gps.liot.cl/api/devices/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0,
    "name": "",
    "uniqueId": "",
    "status": "",
    "disabled": false,
    "lastUpdate": "2026-01-01T00:00:00Z",
    "positionId": "",
    "groupId": "",
    "phone": "",
    "model": "",
    "contact": "",
    "category": "",
    "attributes": {}
  }'

DELETE/devices/{id}#

Eliminar un dispositivo

keyRequiere autenticacióndevices_otherDispositivos

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Respuestas

204	No Content
401	Unauthorized

terminalEjemplo cURL

curl -X DELETE "https://gps.liot.cl/api/devices/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

PUT/devices/{id}/accumulators#

Actualizar la distancia y las horas totales del dispositivo

keyRequiere autenticacióndevices_otherDispositivos

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Cuerpo de la petición application/json

Esquema: DeviceAccumulators

{
  "deviceId": 0,
  "totalDistance": 0,
  "hours": 0
}

Respuestas

204	No Content
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X PUT "https://gps.liot.cl/api/devices/1/accumulators" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "deviceId": 0,
    "totalDistance": 0,
    "hours": 0
  }'

POST/devices/{id}/image#

Subir o actualizar la imagen del dispositivo

keyRequiere autenticacióndevices_otherDispositivos

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Cuerpo de la petición image/*

Esquema: string

Respuestas

200	OK
400	Invalid image type or size
404	Device not found

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/devices/1/image" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: image/*" \
  --data-binary "@/ruta/local/imagen.png"

location_on

Posiciones

Ubicación, historial, kilómetros y exportación de recorridos.

GET/positions#

Listar posiciones

Recomendamos usar la API WebSocket en tiempo real en lugar de consultar repetidamente este endpoint. Sin parámetros, devuelve la última posición conocida de todos los dispositivos del usuario. Los campos `from` y `to` no son obligatorios cuando se usa `id`.

keyRequiere autenticaciónlocation_onPosiciones

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`deviceId`	query	integer	no	`deviceId` es opcional, pero requiere los parámetros `from` y `to` cuando se usa.
`from`	query	string	no	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`to`	query	string	no	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`id`	query	integer	no	Para obtener una o varias posiciones. Se pueden pasar varios parámetros como `id=31&id=42`.

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/positions" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

DELETE/positions#

Eliminar las posiciones de un dispositivo en un rango de tiempo

keyRequiere autenticaciónlocation_onPosiciones

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`deviceId`	query	integer	sí	—
`from`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`to`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.

Respuestas

204	No Content
400	Bad request

terminalEjemplo cURL

curl -X DELETE "https://gps.liot.cl/api/positions" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

DELETE/positions/{id}#

Eliminar una posición

keyRequiere autenticaciónlocation_onPosiciones

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Respuestas

204	No Content
404	Not found

terminalEjemplo cURL

curl -X DELETE "https://gps.liot.cl/api/positions/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

GET/positions/kml#

Exportar posiciones en KML

keyRequiere autenticaciónlocation_onPosiciones

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`deviceId`	query	integer	sí	—
`from`	query	string	sí	—
`to`	query	string	sí	—

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/positions/kml?deviceId=1&from=1&to=1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

GET/positions/csv#

Exportar posiciones en CSV

keyRequiere autenticaciónlocation_onPosiciones

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`deviceId`	query	integer	sí	—
`geofenceId`	query	integer	no	—
`from`	query	string	sí	—
`to`	query	string	sí	—

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/positions/csv?deviceId=1&from=1&to=1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

GET/positions/gpx#

Exportar posiciones en GPX

keyRequiere autenticaciónlocation_onPosiciones

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`deviceId`	query	integer	sí	—
`from`	query	string	sí	—
`to`	query	string	sí	—

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/positions/gpx?deviceId=1&from=1&to=1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

Comparte la ubicación de dispositivos o grupos mediante enlaces temporales.

POST/share/device#

Compartir la ubicación de un dispositivo

keyRequiere autenticaciónshareCompartir

Cuerpo de la petición application/x-www-form-urlencoded

Esquema: object

Respuestas

200	OK
403	Sharing is disabled or temporary user

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/share/device" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -d "campo=valor"

POST/share/group#

Compartir los dispositivos de un grupo

keyRequiere autenticaciónshareCompartir

Cuerpo de la petición application/x-www-form-urlencoded

Esquema: object

Respuestas

200	OK
403	Sharing is disabled or temporary user

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/share/group" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -d "campo=valor"

videocam

Video en vivo

Transmisión de video HLS desde cámaras asociadas a los dispositivos.

GET/stream/{deviceId}/{channel}/live.m3u8#

Obtener la lista de reproducción HLS de una cámara

keyRequiere autenticaciónvideocamVideo en vivo

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`deviceId`	path	integer	sí	—
`channel`	path	integer	sí	—

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/stream/1/1/live.m3u8" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

GET/stream/{deviceId}/{channel}/{index}.ts#

Obtener un segmento de video HLS de una cámara

keyRequiere autenticaciónvideocamVideo en vivo

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`deviceId`	path	integer	sí	—
`channel`	path	integer	sí	—
`index`	path	integer	sí	—

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/stream/1/1/0.ts" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

insights

Reportes

Resúmenes, recorridos, detenciones, eventos y geocercas por período.

GET/reports/combined#

Reporte combinado de recorrido, eventos y posiciones

Se debe indicar al menos un `deviceId` o un `groupId`.

keyRequiere autenticacióninsightsReportes

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`deviceId`	query	array	no	—
`groupId`	query	array	no	—
`from`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`to`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/reports/combined?from=1&to=1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

GET/reports/route#

Recorrido de posiciones en un período

Se debe indicar al menos un `deviceId` o un `groupId`.

keyRequiere autenticacióninsightsReportes

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`deviceId`	query	array	no	—
`groupId`	query	array	no	—
`from`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`to`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/reports/route?from=1&to=1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

GET/reports/route/{type}#

Descargar o enviar por correo el reporte de recorrido

Usa `type=xlsx` para descargar el reporte o `type=mail` para enviarlo por correo de forma asíncrona.

keyRequiere autenticacióninsightsReportes

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`type`	path	string xlsx · mail	sí	—
`deviceId`	query	array	no	—
`groupId`	query	array	no	—
`from`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`to`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.

Respuestas

200	Spreadsheet attachment
204	Report queued for email delivery
401	Unauthorized
404	Not found

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/reports/route/valor?from=1&to=1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

GET/reports/events#

Eventos en un período

Se debe indicar al menos un `deviceId` o un `groupId`.

keyRequiere autenticacióninsightsReportes

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`deviceId`	query	array	no	—
`groupId`	query	array	no	—
`type`	query	array	no	Se puede usar `%` para devolver eventos de todos los tipos.
`from`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`to`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/reports/events?from=1&to=1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

GET/reports/events/{type}#

Descargar o enviar por correo el reporte de eventos

Usa `type=xlsx` para descargar el reporte o `type=mail` para enviarlo por correo de forma asíncrona.

keyRequiere autenticacióninsightsReportes

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`type`	path	string xlsx · mail	sí	—
`deviceId`	query	array	no	—
`groupId`	query	array	no	—
`type`	query	array	no	Tipos de evento a incluir; `%` incluye todos.
`alarm`	query	array	no	Tipos de alarma a incluir.
`from`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`to`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.

Respuestas

200	Spreadsheet attachment
204	Report queued for email delivery
401	Unauthorized
404	Not found

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/reports/events/valor?from=1&to=1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

GET/reports/geofences#

Intervalos de entrada y salida de geocercas

Se debe indicar al menos un `deviceId` o un `groupId`.

keyRequiere autenticacióninsightsReportes

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`deviceId`	query	array	no	—
`groupId`	query	array	no	—
`geofenceId`	query	array	no	—
`from`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`to`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/reports/geofences?from=1&to=1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

GET/reports/summary#

Resumen de actividad en un período

Se debe indicar al menos un `deviceId` o un `groupId`.

keyRequiere autenticacióninsightsReportes

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`deviceId`	query	array	no	—
`groupId`	query	array	no	—
`from`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`to`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/reports/summary?from=1&to=1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

GET/reports/summary/{type}#

Descargar o enviar por correo el reporte de resumen

Usa `type=xlsx` para descargar el reporte o `type=mail` para enviarlo por correo de forma asíncrona.

keyRequiere autenticacióninsightsReportes

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`type`	path	string xlsx · mail	sí	—
`deviceId`	query	array	no	—
`groupId`	query	array	no	—
`from`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`to`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`daily`	query	boolean	no	Agrega los valores por día en lugar de todo el período.

Respuestas

200	Spreadsheet attachment
204	Report queued for email delivery
401	Unauthorized
404	Not found

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/reports/summary/valor?from=1&to=1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

GET/reports/trips#

Viajes en un período

Se debe indicar al menos un `deviceId` o un `groupId`.

keyRequiere autenticacióninsightsReportes

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`deviceId`	query	array	no	—
`groupId`	query	array	no	—
`from`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`to`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/reports/trips?from=1&to=1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

GET/reports/trips/{type}#

Descargar o enviar por correo el reporte de viajes

Usa `type=xlsx` para descargar el reporte o `type=mail` para enviarlo por correo de forma asíncrona.

keyRequiere autenticacióninsightsReportes

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`type`	path	string xlsx · mail	sí	—
`deviceId`	query	array	no	—
`groupId`	query	array	no	—
`from`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`to`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.

Respuestas

200	Spreadsheet attachment
204	Report queued for email delivery
401	Unauthorized
404	Not found

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/reports/trips/valor?from=1&to=1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

GET/reports/stops#

Detenciones en un período

Se debe indicar al menos un `deviceId` o un `groupId`.

keyRequiere autenticacióninsightsReportes

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`deviceId`	query	array	no	—
`groupId`	query	array	no	—
`from`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`to`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/reports/stops?from=1&to=1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

GET/reports/stops/{type}#

Descargar o enviar por correo el reporte de detenciones

Usa `type=xlsx` para descargar el reporte o `type=mail` para enviarlo por correo de forma asíncrona.

keyRequiere autenticacióninsightsReportes

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`type`	path	string xlsx · mail	sí	—
`deviceId`	query	array	no	—
`groupId`	query	array	no	—
`from`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`to`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.

Respuestas

200	Spreadsheet attachment
204	Report queued for email delivery
401	Unauthorized
404	Not found

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/reports/stops/valor?from=1&to=1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

GET/reports/devices/{type}#

Descargar o enviar por correo el reporte de dispositivos

Usa `type=xlsx` para descargar el reporte o `type=mail` para enviarlo por correo de forma asíncrona.

keyRequiere autenticacióninsightsReportes

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`type`	path	string xlsx · mail	sí	—

Respuestas

200	Spreadsheet attachment
204	Report queued for email delivery
401	Unauthorized
404	Not found

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/reports/devices/valor" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

bolt

Eventos

Eventos generados por los dispositivos (encendido, alarmas, excesos de velocidad, etc.).

GET/events/{id}#

Obtener un evento

Devuelve un evento con todo su contexto para el identificador indicado.

keyRequiere autenticaciónboltEventos

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Respuestas

200	OK
401	Unauthorized
404	Not found

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/events/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

fence

Geocercas

Zonas geográficas para alertas de entrada y salida.

GET/geofences#

Listar geocercas

Sin parámetros, devuelve las geocercas a las que el usuario tiene acceso.

keyRequiere autenticaciónfenceGeocercas

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`all`	query	boolean	no	Solo administradores o gerentes pueden consultar todas las entidades.
`userId`	query	integer	no	Los usuarios estándar solo pueden usarlo con su propio `userId`.
`deviceId`	query	integer	no	Los usuarios estándar solo pueden usarlo con dispositivos a los que tengan acceso.
`groupId`	query	integer	no	Los usuarios estándar solo pueden usarlo con grupos a los que tengan acceso.
`refresh`	query	boolean	no	—
`limit`	query	integer	no	Limita la cantidad de resultados devueltos.
`offset`	query	integer	no	Desplazamiento para paginación.
`keyword`	query	string	no	Filtro por palabra clave.

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/geofences" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

POST/geofences#

Crear una geocerca

keyRequiere autenticaciónfenceGeocercas

Cuerpo de la petición application/json

Esquema: Geofence

{
  "id": 0,
  "name": "",
  "description": "",
  "area": "",
  "calendarId": 0,
  "attributes": {}
}

Respuestas

200	OK
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/geofences" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0,
    "name": "",
    "description": "",
    "area": "",
    "calendarId": 0,
    "attributes": {}
  }'

GET/geofences/{id}#

Obtener una geocerca

keyRequiere autenticaciónfenceGeocercas

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Respuestas

200	OK
401	Unauthorized
404	Not found

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/geofences/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

PUT/geofences/{id}#

Actualizar una geocerca

keyRequiere autenticaciónfenceGeocercas

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Cuerpo de la petición application/json

Esquema: Geofence

{
  "id": 0,
  "name": "",
  "description": "",
  "area": "",
  "calendarId": 0,
  "attributes": {}
}

Respuestas

200	OK
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X PUT "https://gps.liot.cl/api/geofences/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0,
    "name": "",
    "description": "",
    "area": "",
    "calendarId": 0,
    "attributes": {}
  }'

DELETE/geofences/{id}#

Eliminar una geocerca

keyRequiere autenticaciónfenceGeocercas

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Respuestas

204	No Content
401	Unauthorized

terminalEjemplo cURL

curl -X DELETE "https://gps.liot.cl/api/geofences/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

workspaces

Grupos

Agrupación de dispositivos y usuarios.

GET/groups#

Listar grupos

Sin parámetros, devuelve los grupos a los que pertenece el usuario.

keyRequiere autenticaciónworkspacesGrupos

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`all`	query	boolean	no	Solo administradores o gerentes pueden consultar todas las entidades.
`userId`	query	integer	no	Los usuarios estándar solo pueden usarlo con su propio `userId`.
`limit`	query	integer	no	Limita la cantidad de resultados devueltos.
`offset`	query	integer	no	Desplazamiento para paginación.
`keyword`	query	string	no	Filtro por palabra clave.

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/groups" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

POST/groups#

Crear un grupo

keyRequiere autenticaciónworkspacesGrupos

Cuerpo de la petición application/json

Esquema: Group

{
  "id": 0,
  "name": "",
  "groupId": 0,
  "attributes": {}
}

Respuestas

200	OK
400	No permission

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/groups" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0,
    "name": "",
    "groupId": 0,
    "attributes": {}
  }'

GET/groups/{id}#

Obtener un grupo

keyRequiere autenticaciónworkspacesGrupos

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Respuestas

200	OK
401	Unauthorized
404	Not found

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/groups/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

PUT/groups/{id}#

Actualizar un grupo

keyRequiere autenticaciónworkspacesGrupos

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Cuerpo de la petición application/json

Esquema: Group

{
  "id": 0,
  "name": "",
  "groupId": 0,
  "attributes": {}
}

Respuestas

200	OK
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X PUT "https://gps.liot.cl/api/groups/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0,
    "name": "",
    "groupId": 0,
    "attributes": {}
  }'

DELETE/groups/{id}#

Eliminar un grupo

keyRequiere autenticaciónworkspacesGrupos

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Respuestas

204	No Content
401	Unauthorized

terminalEjemplo cURL

curl -X DELETE "https://gps.liot.cl/api/groups/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

notifications

Notificaciones

Reglas de alerta por evento y canales de envío.

GET/notifications#

Listar notificaciones

Sin parámetros, devuelve las notificaciones a las que el usuario tiene acceso.

keyRequiere autenticaciónnotificationsNotificaciones

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`all`	query	boolean	no	Solo administradores o gerentes pueden consultar todas las entidades.
`userId`	query	integer	no	Los usuarios estándar solo pueden usarlo con su propio `userId`.
`deviceId`	query	integer	no	Los usuarios estándar solo pueden usarlo con dispositivos a los que tengan acceso.
`groupId`	query	integer	no	Los usuarios estándar solo pueden usarlo con grupos a los que tengan acceso.
`refresh`	query	boolean	no	—
`limit`	query	integer	no	Limita la cantidad de resultados devueltos.
`offset`	query	integer	no	Desplazamiento para paginación.
`keyword`	query	string	no	Filtro por palabra clave.

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/notifications" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

POST/notifications#

Crear una notificación

keyRequiere autenticaciónnotificationsNotificaciones

Cuerpo de la petición application/json

Esquema: Notification

{
  "id": 0,
  "type": "",
  "description": "",
  "always": false,
  "commandId": 0,
  "notificators": "",
  "calendarId": 0,
  "attributes": {}
}

Respuestas

200	OK
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/notifications" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0,
    "type": "",
    "description": "",
    "always": false,
    "commandId": 0,
    "notificators": "",
    "calendarId": 0,
    "attributes": {}
  }'

GET/notifications/{id}#

Obtener una notificación

keyRequiere autenticaciónnotificationsNotificaciones

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Respuestas

200	OK
401	Unauthorized
404	Not found

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/notifications/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

PUT/notifications/{id}#

Actualizar una notificación

keyRequiere autenticaciónnotificationsNotificaciones

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Cuerpo de la petición application/json

Esquema: Notification

{
  "id": 0,
  "type": "",
  "description": "",
  "always": false,
  "commandId": 0,
  "notificators": "",
  "calendarId": 0,
  "attributes": {}
}

Respuestas

200	OK
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X PUT "https://gps.liot.cl/api/notifications/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0,
    "type": "",
    "description": "",
    "always": false,
    "commandId": 0,
    "notificators": "",
    "calendarId": 0,
    "attributes": {}
  }'

DELETE/notifications/{id}#

Eliminar una notificación

keyRequiere autenticaciónnotificationsNotificaciones

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Respuestas

204	No Content
401	Unauthorized

terminalEjemplo cURL

curl -X DELETE "https://gps.liot.cl/api/notifications/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

GET/notifications/types#

Listar los tipos de notificación disponibles

keyRequiere autenticaciónnotificationsNotificaciones

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/notifications/types" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

GET/notifications/notificators#

Listar los canales de notificación disponibles

keyRequiere autenticaciónnotificationsNotificaciones

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`announcement`	query	boolean	no	Con `true`, excluye los canales que no pueden entregar anuncios.

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/notifications/notificators" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

POST/notifications/test#

Enviar una notificación de prueba al usuario por correo y SMS

keyRequiere autenticaciónnotificationsNotificaciones

Respuestas

204	Successful sending
400	Could happen if sending has failed

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/notifications/test" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

POST/notifications/test/{notificator}#

Enviar una notificación de prueba por un canal específico

keyRequiere autenticaciónnotificationsNotificaciones

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`notificator`	path	string	sí	—

Respuestas

204	Successful sending
400	Could happen if sending has failed

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/notifications/test/valor" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

POST/notifications/send/{notificator}#

Enviar una notificación personalizada a usuarios seleccionados

keyRequiere autenticaciónnotificationsNotificaciones

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`notificator`	path	string	sí	—
`userId`	query	array	no	Lista opcional de ids de usuario destino; si se omite, envía a todos los usuarios permitidos.

Cuerpo de la petición application/json

Esquema: NotificationMessage

{
  "subject": "",
  "digest": "",
  "body": "",
  "priority": false
}

Respuestas

204	Successful sending
400	Could happen if sending has failed

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/notifications/send/valor" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "",
    "digest": "",
    "body": "",
    "priority": false
  }'

terminal

Comandos

Comandos guardados y envío de instrucciones a los equipos.

GET/commands#

Listar comandos guardados

Sin parámetros, devuelve los comandos guardados a los que el usuario tiene acceso.

keyRequiere autenticaciónterminalComandos

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`all`	query	boolean	no	Solo administradores o gerentes pueden consultar todas las entidades.
`userId`	query	integer	no	Los usuarios estándar solo pueden usarlo con su propio `userId`.
`deviceId`	query	integer	no	Los usuarios estándar solo pueden usarlo con dispositivos a los que tengan acceso.
`groupId`	query	integer	no	Los usuarios estándar solo pueden usarlo con grupos a los que tengan acceso.
`refresh`	query	boolean	no	—
`limit`	query	integer	no	Limita la cantidad de resultados devueltos.
`offset`	query	integer	no	Desplazamiento para paginación.
`keyword`	query	string	no	Filtro por palabra clave.

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/commands" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

POST/commands#

Crear un comando guardado

keyRequiere autenticaciónterminalComandos

Cuerpo de la petición application/json

Esquema: Command

{
  "id": 0,
  "deviceId": 0,
  "description": "",
  "type": "",
  "textChannel": false,
  "attributes": {}
}

Respuestas

200	OK
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/commands" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0,
    "deviceId": 0,
    "description": "",
    "type": "",
    "textChannel": false,
    "attributes": {}
  }'

GET/commands/{id}#

Obtener un comando guardado

keyRequiere autenticaciónterminalComandos

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Respuestas

200	OK
401	Unauthorized
404	Not found

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/commands/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

PUT/commands/{id}#

Actualizar un comando guardado

keyRequiere autenticaciónterminalComandos

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Cuerpo de la petición application/json

Esquema: Command

{
  "id": 0,
  "deviceId": 0,
  "description": "",
  "type": "",
  "textChannel": false,
  "attributes": {}
}

Respuestas

200	OK
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X PUT "https://gps.liot.cl/api/commands/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0,
    "deviceId": 0,
    "description": "",
    "type": "",
    "textChannel": false,
    "attributes": {}
  }'

DELETE/commands/{id}#

Eliminar un comando guardado

keyRequiere autenticaciónterminalComandos

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Respuestas

204	No Content
401	Unauthorized

terminalEjemplo cURL

curl -X DELETE "https://gps.liot.cl/api/commands/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

GET/commands/send#

Listar los comandos soportados por el dispositivo en este momento

Devuelve los comandos guardados vinculados al dispositivo y sus grupos, según el protocolo soportado.

keyRequiere autenticaciónterminalComandos

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`deviceId`	query	integer	sí	Los usuarios estándar solo pueden usarlo con dispositivos a los que tengan acceso.

Respuestas

200	OK
400	Could happen when the user doesn't have permission for the device

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/commands/send?deviceId=1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

POST/commands/send#

Enviar comandos al dispositivo

Envía un comando nuevo, o uno guardado si se define `body.id`.

keyRequiere autenticaciónterminalComandos

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`groupId`	query	integer	no	Envía el comando a todos los dispositivos del grupo.

Cuerpo de la petición application/json

Esquema: Command

{
  "id": 0,
  "deviceId": 0,
  "description": "",
  "type": "",
  "textChannel": false,
  "attributes": {}
}

Respuestas

200	Command sent
202	Command queued
400	Could happen when the user doesn't have permission or an incorrect command _type_ for the device

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/commands/send" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0,
    "deviceId": 0,
    "description": "",
    "type": "",
    "textChannel": false,
    "attributes": {}
  }'

GET/commands/types#

Listar los comandos disponibles para el dispositivo

keyRequiere autenticaciónterminalComandos

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`deviceId`	query	integer	no	Identificador interno del dispositivo. Solo funciona si el dispositivo ya reportó ubicaciones.
`textChannel`	query	boolean	no	Con `true` devuelve comandos SMS; en otro caso devuelve comandos de datos.

Respuestas

200	OK
400	Could happen when trying to fetch from a device the user does not have permission

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/commands/types" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

badge

Conductores

Registro de conductores y asignación a vehículos.

GET/drivers#

Listar conductores

Sin parámetros, devuelve los conductores a los que el usuario tiene acceso.

keyRequiere autenticaciónbadgeConductores

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`all`	query	boolean	no	Solo administradores o gerentes pueden consultar todas las entidades.
`userId`	query	integer	no	Los usuarios estándar solo pueden usarlo con su propio `userId`.
`deviceId`	query	integer	no	Los usuarios estándar solo pueden usarlo con dispositivos a los que tengan acceso.
`groupId`	query	integer	no	Los usuarios estándar solo pueden usarlo con grupos a los que tengan acceso.
`refresh`	query	boolean	no	—
`limit`	query	integer	no	Limita la cantidad de resultados devueltos.
`offset`	query	integer	no	Desplazamiento para paginación.
`keyword`	query	string	no	Filtro por palabra clave.

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/drivers" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

POST/drivers#

Crear un conductor

keyRequiere autenticaciónbadgeConductores

Cuerpo de la petición application/json

Esquema: Driver

{
  "id": 0,
  "name": "",
  "uniqueId": "",
  "attributes": {}
}

Respuestas

200	OK
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/drivers" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0,
    "name": "",
    "uniqueId": "",
    "attributes": {}
  }'

GET/drivers/{id}#

Obtener un conductor

keyRequiere autenticaciónbadgeConductores

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Respuestas

200	OK
401	Unauthorized
404	Not found

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/drivers/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

PUT/drivers/{id}#

Actualizar un conductor

keyRequiere autenticaciónbadgeConductores

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Cuerpo de la petición application/json

Esquema: Driver

{
  "id": 0,
  "name": "",
  "uniqueId": "",
  "attributes": {}
}

Respuestas

200	OK
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X PUT "https://gps.liot.cl/api/drivers/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0,
    "name": "",
    "uniqueId": "",
    "attributes": {}
  }'

DELETE/drivers/{id}#

Eliminar un conductor

keyRequiere autenticaciónbadgeConductores

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Respuestas

204	No Content
401	Unauthorized

terminalEjemplo cURL

curl -X DELETE "https://gps.liot.cl/api/drivers/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

build

Mantenimiento

Planes de mantenimiento y control por kilometraje u horas.

GET/maintenance#

Listar tareas de mantenimiento

Sin parámetros, devuelve las tareas de mantenimiento a las que el usuario tiene acceso.

keyRequiere autenticaciónbuildMantenimiento

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`all`	query	boolean	no	Solo administradores o gerentes pueden consultar todas las entidades.
`userId`	query	integer	no	Los usuarios estándar solo pueden usarlo con su propio `userId`.
`deviceId`	query	integer	no	Los usuarios estándar solo pueden usarlo con dispositivos a los que tengan acceso.
`groupId`	query	integer	no	Los usuarios estándar solo pueden usarlo con grupos a los que tengan acceso.
`refresh`	query	boolean	no	—
`limit`	query	integer	no	Limita la cantidad de resultados devueltos.
`offset`	query	integer	no	Desplazamiento para paginación.
`keyword`	query	string	no	Filtro por palabra clave.

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/maintenance" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

POST/maintenance#

Crear una tarea de mantenimiento

keyRequiere autenticaciónbuildMantenimiento

Cuerpo de la petición application/json

Esquema: Maintenance

{
  "id": 0,
  "name": "",
  "type": "",
  "start": 0,
  "period": 0,
  "attributes": {}
}

Respuestas

200	OK
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/maintenance" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0,
    "name": "",
    "type": "",
    "start": 0,
    "period": 0,
    "attributes": {}
  }'

GET/maintenance/{id}#

Obtener una tarea de mantenimiento

keyRequiere autenticaciónbuildMantenimiento

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Respuestas

200	OK
401	Unauthorized
404	Not found

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/maintenance/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

PUT/maintenance/{id}#

Actualizar una tarea de mantenimiento

keyRequiere autenticaciónbuildMantenimiento

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Cuerpo de la petición application/json

Esquema: Maintenance

{
  "id": 0,
  "name": "",
  "type": "",
  "start": 0,
  "period": 0,
  "attributes": {}
}

Respuestas

200	OK
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X PUT "https://gps.liot.cl/api/maintenance/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0,
    "name": "",
    "type": "",
    "start": 0,
    "period": 0,
    "attributes": {}
  }'

DELETE/maintenance/{id}#

Eliminar una tarea de mantenimiento

keyRequiere autenticaciónbuildMantenimiento

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Respuestas

204	No Content
401	Unauthorized

terminalEjemplo cURL

curl -X DELETE "https://gps.liot.cl/api/maintenance/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

calendar_month

Calendarios

Horarios y ventanas de tiempo para notificaciones.

GET/calendars#

Listar calendarios

Sin parámetros, devuelve los calendarios a los que el usuario tiene acceso.

keyRequiere autenticacióncalendar_monthCalendarios

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`all`	query	boolean	no	Solo administradores o gerentes pueden consultar todas las entidades.
`userId`	query	integer	no	Los usuarios estándar solo pueden usarlo con su propio `userId`.
`limit`	query	integer	no	Limita la cantidad de resultados devueltos.
`offset`	query	integer	no	Desplazamiento para paginación.
`keyword`	query	string	no	Filtro por palabra clave.

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/calendars" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

POST/calendars#

Crear un calendario

keyRequiere autenticacióncalendar_monthCalendarios

Cuerpo de la petición application/json

Esquema: Calendar

{
  "id": 0,
  "name": "",
  "data": "",
  "attributes": {}
}

Respuestas

200	OK
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/calendars" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0,
    "name": "",
    "data": "",
    "attributes": {}
  }'

GET/calendars/{id}#

Obtener un calendario

keyRequiere autenticacióncalendar_monthCalendarios

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Respuestas

200	OK
401	Unauthorized
404	Not found

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/calendars/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

PUT/calendars/{id}#

Actualizar un calendario

keyRequiere autenticacióncalendar_monthCalendarios

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Cuerpo de la petición application/json

Esquema: Calendar

{
  "id": 0,
  "name": "",
  "data": "",
  "attributes": {}
}

Respuestas

200	OK
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X PUT "https://gps.liot.cl/api/calendars/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0,
    "name": "",
    "data": "",
    "attributes": {}
  }'

DELETE/calendars/{id}#

Eliminar un calendario

keyRequiere autenticacióncalendar_monthCalendarios

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Respuestas

204	No Content
401	Unauthorized

terminalEjemplo cURL

curl -X DELETE "https://gps.liot.cl/api/calendars/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

receipt_long

Órdenes

Órdenes y servicios asociados a los vehículos.

GET/orders#

Listar órdenes

Sin parámetros, devuelve las órdenes a las que el usuario tiene acceso.

keyRequiere autenticaciónreceipt_longÓrdenes

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`all`	query	boolean	no	Solo administradores o gerentes pueden consultar todas las entidades.
`userId`	query	integer	no	Los usuarios estándar solo pueden usarlo con su propio `userId`.
`excludeAttributes`	query	boolean	no	Omite el mapa de atributos en la respuesta.
`limit`	query	integer	no	Limita la cantidad de resultados devueltos.
`offset`	query	integer	no	Desplazamiento para paginación.
`keyword`	query	string	no	Filtro por palabra clave.

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/orders" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

POST/orders#

Crear una orden

keyRequiere autenticaciónreceipt_longÓrdenes

Cuerpo de la petición application/json

Esquema: Order

{
  "id": 0,
  "uniqueId": "",
  "description": "",
  "fromAddress": "",
  "toAddress": "",
  "attributes": {}
}

Respuestas

200	OK
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/orders" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0,
    "uniqueId": "",
    "description": "",
    "fromAddress": "",
    "toAddress": "",
    "attributes": {}
  }'

GET/orders/{id}#

Obtener una orden

keyRequiere autenticaciónreceipt_longÓrdenes

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Respuestas

200	OK
401	Unauthorized
404	Not found

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/orders/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

PUT/orders/{id}#

Actualizar una orden

keyRequiere autenticaciónreceipt_longÓrdenes

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Cuerpo de la petición application/json

Esquema: Order

{
  "id": 0,
  "uniqueId": "",
  "description": "",
  "fromAddress": "",
  "toAddress": "",
  "attributes": {}
}

Respuestas

200	OK
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X PUT "https://gps.liot.cl/api/orders/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0,
    "uniqueId": "",
    "description": "",
    "fromAddress": "",
    "toAddress": "",
    "attributes": {}
  }'

DELETE/orders/{id}#

Eliminar una orden

keyRequiere autenticaciónreceipt_longÓrdenes

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Respuestas

204	No Content
401	Unauthorized

terminalEjemplo cURL

curl -X DELETE "https://gps.liot.cl/api/orders/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

tune

Atributos calculados

Atributos derivados y personalizados de los dispositivos.

GET/attributes/computed#

Listar atributos

Sin parámetros, devuelve los atributos a los que el usuario tiene acceso.

keyRequiere autenticacióntuneAtributos calculados

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`all`	query	boolean	no	Solo administradores o gerentes pueden consultar todas las entidades.
`userId`	query	integer	no	Los usuarios estándar solo pueden usarlo con su propio `userId`.
`deviceId`	query	integer	no	Los usuarios estándar solo pueden usarlo con dispositivos a los que tengan acceso.
`groupId`	query	integer	no	Los usuarios estándar solo pueden usarlo con grupos a los que tengan acceso.
`refresh`	query	boolean	no	—
`limit`	query	integer	no	Limita la cantidad de resultados devueltos.
`offset`	query	integer	no	Desplazamiento para paginación.
`keyword`	query	string	no	Filtro por palabra clave.

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/attributes/computed" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

POST/attributes/computed#

Crear un atributo

keyRequiere autenticacióntuneAtributos calculados

Cuerpo de la petición application/json

Esquema: Attribute

{
  "id": 0,
  "description": "",
  "attribute": "",
  "expression": "",
  "type": ""
}

Respuestas

200	OK
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/attributes/computed" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0,
    "description": "",
    "attribute": "",
    "expression": "",
    "type": ""
  }'

POST/attributes/computed/test#

Evaluar un atributo calculado con la última posición

Solo administradores. Devuelve el valor calculado sin guardar el atributo.

keyRequiere autenticacióntuneAtributos calculados

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`deviceId`	query	integer	sí	—

Cuerpo de la petición application/json

Esquema: Attribute

{
  "id": 0,
  "description": "",
  "attribute": "",
  "expression": "",
  "type": ""
}

Respuestas

200	OK
204	Computation produced no value
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/attributes/computed/test" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0,
    "description": "",
    "attribute": "",
    "expression": "",
    "type": ""
  }'

GET/attributes/computed/{id}#

Obtener un atributo

keyRequiere autenticacióntuneAtributos calculados

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Respuestas

200	OK
401	Unauthorized
404	Not found

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/attributes/computed/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

PUT/attributes/computed/{id}#

Actualizar un atributo

keyRequiere autenticacióntuneAtributos calculados

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Cuerpo de la petición application/json

Esquema: Attribute

{
  "id": 0,
  "description": "",
  "attribute": "",
  "expression": "",
  "type": ""
}

Respuestas

200	OK
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X PUT "https://gps.liot.cl/api/attributes/computed/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0,
    "description": "",
    "attribute": "",
    "expression": "",
    "type": ""
  }'

DELETE/attributes/computed/{id}#

Eliminar un atributo

keyRequiere autenticacióntuneAtributos calculados

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Respuestas

204	No Content
401	Unauthorized

terminalEjemplo cURL

curl -X DELETE "https://gps.liot.cl/api/attributes/computed/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

group

Usuarios

Gestión de usuarios, roles y permisos de la plataforma.

GET/users#

Listar usuarios

keyRequiere autenticacióngroupUsuarios

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`userId`	query	string	no	Solo disponible para usuarios administradores o gerentes.
`limit`	query	integer	no	Limita la cantidad de resultados devueltos.
`offset`	query	integer	no	Desplazamiento para paginación.
`keyword`	query	string	no	Filtro por palabra clave (busca en nombre y correo).

Respuestas

200	OK
400	No Permission

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/users" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

POST/users#

Crear un usuario

keyRequiere autenticacióngroupUsuarios

Cuerpo de la petición application/json

Esquema: User

{
  "id": 0,
  "name": "",
  "email": "",
  "phone": "",
  "readonly": false,
  "administrator": false,
  "map": "",
  "latitude": 0,
  "longitude": 0,
  "zoom": 0,
  "password": "",
  "coordinateFormat": "",
  "disabled": false,
  "expirationTime": "2026-01-01T00:00:00Z",
  "deviceLimit": 0,
  "userLimit": 0,
  "deviceReadonly": false,
  "limitCommands": false,
  "fixedEmail": false,
  "poiLayer": "",
  "attributes": {}
}

Respuestas

200	OK
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/users" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0,
    "name": "",
    "email": "",
    "phone": "",
    "readonly": false,
    "administrator": false,
    "map": "",
    "latitude": 0,
    "longitude": 0,
    "zoom": 0,
    "password": "",
    "coordinateFormat": "",
    "disabled": false,
    "expirationTime": "2026-01-01T00:00:00Z",
    "deviceLimit": 0,
    "userLimit": 0,
    "deviceReadonly": false,
    "limitCommands": false,
    "fixedEmail": false,
    "poiLayer": "",
    "attributes": {}
  }'

POST/users/totp#

Generar secreto TOTP

Público · sin autenticacióngroupUsuarios

Respuestas

200	OK
400	Bad request

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/users/totp"

GET/users/{id}#

Obtener un usuario

keyRequiere autenticacióngroupUsuarios

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Respuestas

200	OK
401	Unauthorized
404	Not found

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/users/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

PUT/users/{id}#

Actualizar un usuario

keyRequiere autenticacióngroupUsuarios

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Cuerpo de la petición application/json

Esquema: User

{
  "id": 0,
  "name": "",
  "email": "",
  "phone": "",
  "readonly": false,
  "administrator": false,
  "map": "",
  "latitude": 0,
  "longitude": 0,
  "zoom": 0,
  "password": "",
  "coordinateFormat": "",
  "disabled": false,
  "expirationTime": "2026-01-01T00:00:00Z",
  "deviceLimit": 0,
  "userLimit": 0,
  "deviceReadonly": false,
  "limitCommands": false,
  "fixedEmail": false,
  "poiLayer": "",
  "attributes": {}
}

Respuestas

200	OK
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X PUT "https://gps.liot.cl/api/users/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0,
    "name": "",
    "email": "",
    "phone": "",
    "readonly": false,
    "administrator": false,
    "map": "",
    "latitude": 0,
    "longitude": 0,
    "zoom": 0,
    "password": "",
    "coordinateFormat": "",
    "disabled": false,
    "expirationTime": "2026-01-01T00:00:00Z",
    "deviceLimit": 0,
    "userLimit": 0,
    "deviceReadonly": false,
    "limitCommands": false,
    "fixedEmail": false,
    "poiLayer": "",
    "attributes": {}
  }'

DELETE/users/{id}#

Eliminar un usuario

keyRequiere autenticacióngroupUsuarios

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`	path	integer	sí	—

Respuestas

204	No Content
401	Unauthorized

terminalEjemplo cURL

curl -X DELETE "https://gps.liot.cl/api/users/1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

admin_panel_settings

Permisos

Vinculación de dispositivos, grupos y usuarios.

GET/permissions#

Consultar vínculos de permisos entre objetos

Debes indicar exactamente dos parámetros de consulta `*Id` (por ejemplo `reportId` y `deviceId`). Usa `0` en un lado para indicar "cualquiera", por ejemplo `?reportId=5&deviceId=0` lista todos los dispositivos vinculados al reporte 5. Al menos un lado debe ser distinto de cero.

keyRequiere autenticaciónadmin_panel_settingsPermisos

Respuestas

200	OK
400	Bad request

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/permissions" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

POST/permissions#

Vincular un objeto con otro

keyRequiere autenticaciónadmin_panel_settingsPermisos

Cuerpo de la petición application/json

Esquema: Permission

{
  "userId": 0,
  "deviceId": 0,
  "groupId": 0,
  "geofenceId": 0,
  "notificationId": 0,
  "calendarId": 0,
  "attributeId": 0,
  "driverId": 0,
  "managedUserId": 0,
  "commandId": 0
}

Respuestas

204	No Content
400	No permission

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/permissions" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": 0,
    "deviceId": 0,
    "groupId": 0,
    "geofenceId": 0,
    "notificationId": 0,
    "calendarId": 0,
    "attributeId": 0,
    "driverId": 0,
    "managedUserId": 0,
    "commandId": 0
  }'

DELETE/permissions#

Desvincular un objeto de otro

keyRequiere autenticaciónadmin_panel_settingsPermisos

Cuerpo de la petición application/json

Esquema: Permission

{
  "userId": 0,
  "deviceId": 0,
  "groupId": 0,
  "geofenceId": 0,
  "notificationId": 0,
  "calendarId": 0,
  "attributeId": 0,
  "driverId": 0,
  "managedUserId": 0,
  "commandId": 0
}

Respuestas

204	No Content
401	Unauthorized

terminalEjemplo cURL

curl -X DELETE "https://gps.liot.cl/api/permissions" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": 0,
    "deviceId": 0,
    "groupId": 0,
    "geofenceId": 0,
    "notificationId": 0,
    "calendarId": 0,
    "attributeId": 0,
    "driverId": 0,
    "managedUserId": 0,
    "commandId": 0
  }'

POST/permissions/bulk#

Vincular varios objetos en una sola petición

keyRequiere autenticaciónadmin_panel_settingsPermisos

Cuerpo de la petición application/json

Esquema: array

Respuestas

204	No Content
400	Bad request

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/permissions/bulk" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE/permissions/bulk#

Desvincular varios objetos en una sola petición

keyRequiere autenticaciónadmin_panel_settingsPermisos

Cuerpo de la petición application/json

Esquema: array

Respuestas

204	No Content
400	Bad request

terminalEjemplo cURL

curl -X DELETE "https://gps.liot.cl/api/permissions/bulk" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

bar_chart

Estadísticas

Métricas agregadas del uso de la plataforma.

GET/statistics#

Obtener estadísticas del servidor

keyRequiere autenticaciónbar_chartEstadísticas

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`from`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`to`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/statistics?from=1&to=1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

history

Auditoría

Registro de acciones realizadas en la plataforma.

GET/audit#

Consultar el registro de auditoría

Solo administradores. Devuelve las acciones realizadas en el rango de tiempo indicado.

keyRequiere autenticaciónhistoryAuditoría

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`from`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`to`	query	string	sí	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/audit?from=1&to=1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

lock_reset

Contraseña

Flujo de recuperación y restablecimiento de contraseña.

POST/password/reset#

Enviar correo de restablecimiento de contraseña

Siempre responde `200`, exista o no el correo.

Público · sin autenticaciónlock_resetContraseña

Cuerpo de la petición application/x-www-form-urlencoded

Esquema: object

Respuestas

200	OK
400	Bad request

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/password/reset" \
  -d "email=usuario@empresa.cl" -d "password=CLAVE"

POST/password/update#

Definir una nueva contraseña con el token de restablecimiento

Público · sin autenticaciónlock_resetContraseña

Cuerpo de la petición application/x-www-form-urlencoded

Esquema: object

Respuestas

200	OK
404	User not found

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/password/update" \
  -d "token=TOKEN_DE_RESET" -d "password=NUEVA_CLAVE"

dns

Servidor

Información, geocodificación, zonas horarias y utilidades del servicio.

GET/server#

Obtener información del servidor

Público · sin autenticacióndnsServidor

Respuestas

200	OK
400	Bad request

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/server"

PUT/server#

Actualizar la información del servidor

keyRequiere autenticacióndnsServidor

Cuerpo de la petición application/json

Esquema: Server

{
  "id": 0,
  "registration": false,
  "readonly": false,
  "deviceReadonly": false,
  "limitCommands": false,
  "map": "",
  "bingKey": "",
  "mapUrl": "",
  "poiLayer": "",
  "announcement": "",
  "latitude": 0,
  "longitude": 0,
  "zoom": 0,
  "version": "",
  "forceSettings": false,
  "coordinateFormat": "",
  "openIdEnabled": false,
  "openIdForce": false,
  "attributes": {}
}

Respuestas

200	OK
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X PUT "https://gps.liot.cl/api/server" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0,
    "registration": false,
    "readonly": false,
    "deviceReadonly": false,
    "limitCommands": false,
    "map": "",
    "bingKey": "",
    "mapUrl": "",
    "poiLayer": "",
    "announcement": "",
    "latitude": 0,
    "longitude": 0,
    "zoom": 0,
    "version": "",
    "forceSettings": false,
    "coordinateFormat": "",
    "openIdEnabled": false,
    "openIdForce": false,
    "attributes": {}
  }'

GET/server/geocode#

Geocodificación inversa de coordenadas

keyRequiere autenticacióndnsServidor

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`latitude`	query	number	sí	—
`longitude`	query	number	sí	—

Respuestas

200	OK
401	Unauthorized
500	Reverse geocoding is not enabled

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/server/geocode?latitude=1&longitude=1" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

GET/server/timezones#

Listar zonas horarias disponibles

keyRequiere autenticacióndnsServidor

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/server/timezones" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

POST/server/file/{path}#

Subir un archivo al servidor

keyRequiere autenticacióndnsServidor

Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`path`	path	string	sí	—

Cuerpo de la petición application/octet-stream

Esquema: string

Respuestas

200	OK
400	Bad request

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/server/file/archivo" \
  -H "Authorization: Bearer $LIOT_API_TOKEN" \
  -H "Content-Type: application/octet-stream" \
  --data-binary "@/ruta/local/archivo.bin"

GET/server/gc#

Ejecutar recolección de basura

keyRequiere autenticacióndnsServidor

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/server/gc" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

GET/server/cache#

Consultar el diagnóstico de caché

keyRequiere autenticacióndnsServidor

Respuestas

200	OK
401	Unauthorized

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/server/cache" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

POST/server/reboot#

Reiniciar el proceso del servidor

keyRequiere autenticacióndnsServidor

Respuestas

200	OK
400	Bad request
401	Unauthorized

terminalEjemplo cURL

curl -X POST "https://gps.liot.cl/api/server/reboot" \
  -H "Authorization: Bearer $LIOT_API_TOKEN"

monitor_heart

Estado del servicio

Verificación de disponibilidad para monitoreo.

GET/health#

Verificar el estado del servicio

Devuelve texto plano con el estado para monitoreo de disponibilidad.

Público · sin autenticaciónmonitor_heartEstado del servicio

Respuestas

200	Service is healthy
400	Bad request
500	Service is unavailable

terminalEjemplo cURL

curl -X GET "https://gps.liot.cl/api/health"

databaseModelos de datos

Estructura de los objetos que devuelve la API.

Action9 campos

Campo	Tipo	Descripción
`id`	integer	Unique action identifier
`actionTime`	string (date-time)	When the action was recorded
`address`	string	Client address that initiated the action
`userId`	integer	Identifier of the User who performed the action
`userEmail`	string	Email of the User who performed the action
`actionType`	string	Action category (e.g. login, edit, link)
`objectType`	string	Type of object affected by the action
`objectId`	integer	Identifier of the affected object
`attributes`	object	Additional action attributes

Attribute5 campos

Campo	Tipo	Descripción
`id`	integer	Unique computed attribute identifier
`description`	string	Human readable name of the attribute
`attribute`	string	Attribute name used in expressions
`expression`	string	Expression that defines how the attribute is calculated
`type`	string	String\|Number\|Boolean

Calendar4 campos

Campo	Tipo	Descripción
`id`	integer	Unique calendar identifier
`name`	string	Calendar display name
`data`	string	base64 encoded in iCalendar format
`attributes`	object	Custom calendar attributes

CombinedReportItem4 campos

Campo	Tipo	Descripción
`deviceId`	integer	Device identifier for the report item
`route`	array	Simplified route as `[longitude, latitude]` pairs
`events`	array	—
`positions`	array	—

Command6 campos

Campo	Tipo	Descripción
`id`	integer	Unique saved command identifier
`deviceId`	integer	Target device identifier when the command is bound to one device
`description`	string	User friendly label displayed in the UI
`type`	string	Command type as defined by the device protocol
`textChannel`	boolean	Whether to send the command using the SMS channel
`attributes`	object	Additional parameters required by the command type

CommandType1 campos

Campo	Tipo	Descripción
`type`	string	Command type identifier

Device13 campos

Campo	Tipo	Descripción
`id`	integer	Unique identifier assigned by LIOT
`name`	string	Human friendly device label
`uniqueId`	string	Hardware or protocol specific unique identifier
`status`	string	Current connection status such as `online`, `offline`, or `unknown`
`disabled`	boolean	Whether the device is disabled by an administrator
`lastUpdate`	string,null (date-time)	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`positionId`	integer,null	Identifier of the last known position
`groupId`	integer,null	Parent group identifier when the device is assigned to a group
`phone`	string,null	Contact phone number used for SMS commands
`model`	string,null	Device model or hardware revision
`contact`	string,null	Responsible person's contact information
`category`	string,null	Free form category used for grouping devices in the UI
`attributes`	object	Custom attributes for protocol or business specific data

DeviceAccumulators3 campos

Campo	Tipo	Descripción
`deviceId`	integer	Device identifier for the accumulator entry
`totalDistance`	number	in meters
`hours`	number	Total engine hours recorded by the device

Driver4 campos

Campo	Tipo	Descripción
`id`	integer	Unique driver identifier
`name`	string	Driver full name
`uniqueId`	string	Unique external identifier for the driver
`attributes`	object	Custom driver attributes

Event8 campos

Campo	Tipo	Descripción
`id`	integer	Unique event identifier
`type`	string	Event type name
`eventTime`	string (date-time)	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`deviceId`	integer	Device associated with the event
`positionId`	integer	Position record linked to the event when applicable
`geofenceId`	integer	Geofence referenced by the event if any
`maintenanceId`	integer	Maintenance record tied to the event
`attributes`	object	Additional event-specific attributes

Geofence6 campos

Campo	Tipo	Descripción
`id`	integer	Unique identifier for the geofence
`name`	string	Human-readable name shown in lists and maps
`description`	string	Details about the geofence for display in the UI
`area`	string	Geofence area definition encoded as a WKT string
`calendarId`	integer	Calendar identifier limiting when the geofence is active
`attributes`	object	Custom key-value pairs for integrations or UI overrides

Group4 campos

Campo	Tipo	Descripción
`id`	integer	Unique group identifier
`name`	string	Group display name
`groupId`	integer	Parent group identifier for nested grouping
`attributes`	object	Arbitrary metadata attached to the group

Maintenance6 campos

Campo	Tipo	Descripción
`id`	integer	Unique maintenance item identifier
`name`	string	Maintenance task name
`type`	string	Metric the maintenance is based on
`start`	number	Current accumulated value when maintenance tracking starts
`period`	number	Threshold value after which maintenance is due
`attributes`	object	Custom maintenance attributes

Notification8 campos

Campo	Tipo	Descripción
`id`	integer	Unique identifier for the notification
`type`	string	Notification category such as geofenceEnter or ignitionOn
`description`	string,null	User-defined text describing the notification
`always`	boolean	Whether the notification triggers regardless of schedule
`commandId`	integer	Identifier of the command to send when the notification triggers
`notificators`	string	Comma-separated delivery channels (for example, web, mail)
`calendarId`	integer	Calendar identifier restricting when the notification is active
`attributes`	object	Additional custom attributes used by notificators or templates

NotificationMessage4 campos

Campo	Tipo	Descripción
`subject`	string	Subject or title of the notification
`digest`	string	Short summary shown in compact contexts; defaults to the body when omitted
`body` ·	string	Full notification text
`priority`	boolean	Whether the message should be treated as high priority

NotificationType1 campos

Campo	Tipo	Descripción
`type`	string	Notification type identifier

Order6 campos

Campo	Tipo	Descripción
`id`	integer	Unique order identifier
`uniqueId`	string	External order identifier used by clients
`description`	string	Additional details about the order assignment
`fromAddress`	string	Pickup location address
`toAddress`	string	Destination address
`attributes`	object	Custom order attributes

Permission10 campos

Campo	Tipo	Descripción
`userId`	integer	User id, can be only first parameter
`deviceId`	integer	Device id, can be first parameter or second only in combination with userId
`groupId`	integer	Group id, can be first parameter or second only in combination with userId
`geofenceId`	integer	Geofence id, can be second parameter only
`notificationId`	integer	Notification id, can be second parameter only
`calendarId`	integer	Calendar id, can be second parameter only and only in combination with userId
`attributeId`	integer	Computed attribute id, can be second parameter only
`driverId`	integer	Driver id, can be second parameter only
`managedUserId`	integer	User id, can be second parameter only and only in combination with userId
`commandId`	integer	Saved command id, can be second parameter only

Position17 campos

Campo	Tipo	Descripción
`id`	integer	Unique position record identifier
`deviceId`	integer	Identifier of the device that reported this position
`protocol`	string	Device protocol name that produced the message
`deviceTime`	string (date-time)	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`fixTime`	string (date-time)	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`serverTime`	string (date-time)	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`valid`	boolean	Indicates whether the position was marked as valid by the device
`latitude`	number	Latitude in decimal degrees
`longitude`	number	Longitude in decimal degrees
`altitude`	number	Altitude above sea level in meters
`speed`	number	in knots
`course`	number	Heading in degrees (0-360) where 0 is true north
`address`	string	Resolved reverse-geocoded address if available
`accuracy`	number	Estimated positional accuracy in meters when provided
`network`	object	Network metadata (e.g. cell or Wi‑Fi data) supplied by the device
`geofenceIds`	array	List of geofence ids applicable to this position
`attributes`	object	Custom key-value attributes sent by the device or enrichments

QueuedCommand5 campos

Campo	Tipo	Descripción
`id`	integer	Identifier of the queued command job
`deviceId`	integer	Device identifier the queued command will be delivered to
`type`	string	Command type that will be executed
`textChannel`	boolean	Indicates whether the queued command uses SMS delivery
`attributes`	object	Stored parameters for the queued command

ReportGeofences5 campos

Campo	Tipo	Descripción
`deviceId`	integer	Device identifier for the geofence interval
`deviceName`	string	Human readable device name
`geofenceId`	integer	Geofence identifier
`startTime`	string (date-time)	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`endTime`	string (date-time)	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.

ReportStops10 campos

Campo	Tipo	Descripción
`deviceId`	integer	Device identifier for the stop
`deviceName`	string	Human readable device name
`duration`	integer	Stop duration in seconds
`startTime`	string (date-time)	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`address`	string	Address where the stop occurred
`lat`	number	Stop latitude in decimal degrees
`lon`	number	Stop longitude in decimal degrees
`endTime`	string (date-time)	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`spentFuel`	number	in liters
`engineHours`	integer	Engine hours accumulated during the stop

ReportSummary7 campos

Campo	Tipo	Descripción
`deviceId`	integer	Device identifier for the summary row
`deviceName`	string	Human readable device name
`maxSpeed`	number	in knots
`averageSpeed`	number	in knots
`distance`	number	in meters
`spentFuel`	number	in liters
`engineHours`	integer	Engine hours accumulated for the report period

ReportTrips17 campos

Campo	Tipo	Descripción
`deviceId`	integer	Device identifier for the trip
`deviceName`	string	Human readable device name
`maxSpeed`	number	in knots
`averageSpeed`	number	in knots
`distance`	number	in meters
`spentFuel`	number	in liters
`duration`	integer	Trip duration in seconds
`startTime`	string (date-time)	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`startAddress`	string	Address where the trip started
`startLat`	number	Starting latitude in decimal degrees
`startLon`	number	Starting longitude in decimal degrees
`endTime`	string (date-time)	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`endAddress`	string	Address where the trip ended
`endLat`	number	Ending latitude in decimal degrees
`endLon`	number	Ending longitude in decimal degrees
`driverUniqueId`	string	Unique identifier of the driver assigned to the trip
`driverName`	string	Name of the driver assigned to the trip

Server19 campos

Campo	Tipo	Descripción
`id`	integer	Unique server configuration identifier
`registration`	boolean	Whether new user registrations are allowed
`readonly`	boolean	When true only administrators can modify server-wide settings
`deviceReadonly`	boolean	Disallow device attribute changes for non-admins
`limitCommands`	boolean	Restrict command execution to supported protocol commands
`map`	string	Default map layer identifier
`bingKey`	string	Bing Maps API key used when Bing is selected as a provider
`mapUrl`	string	Custom tile server URL template if configured
`poiLayer`	string	External point-of-interest layer configuration
`announcement`	string	Message displayed to all users in the web application
`latitude`	number	Default map center latitude
`longitude`	number	Default map center longitude
`zoom`	integer	Default map zoom level
`version`	string	LIOT server version string
`forceSettings`	boolean	Forces users to use the server-wide settings instead of their own
`coordinateFormat`	string	Default coordinate format for displaying positions
`openIdEnabled`	boolean	Indicates whether OpenID authentication is available
`openIdForce`	boolean	Require OpenID authentication for all users when enabled
`attributes`	object	Additional server-level configuration values

Statistics6 campos

Campo	Tipo	Descripción
`captureTime`	string (date-time)	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`activeUsers`	integer	Number of active users in the capture period
`activeDevices`	integer	Number of active devices in the capture period
`requests`	integer	Total API requests processed
`messagesReceived`	integer	Number of device messages received
`messagesStored`	integer	Number of device messages stored to the database

User21 campos

Campo	Tipo	Descripción
`id`	integer	Unique user identifier
`name`	string	User display name
`email`	string	Email address used for login and notifications
`phone`	string,null	Contact phone number for alerts
`readonly`	boolean	When true, the user cannot change settings
`administrator`	boolean	Grants full administrative privileges when enabled
`map`	string,null	Preferred default map layer for the user
`latitude`	number	Default map center latitude for this user
`longitude`	number	Default map center longitude for this user
`zoom`	integer	Default map zoom level on login
`password`	string	Password for user authentication
`coordinateFormat`	string,null	Preferred coordinate display format
`disabled`	boolean	Indicates whether the user account is disabled
`expirationTime`	string,null (date-time)	En formato ISO 8601, por ejemplo `1963-11-22T18:30:00Z`.
`deviceLimit`	integer	Maximum number of devices the user can manage
`userLimit`	integer	Maximum number of subordinate users
`deviceReadonly`	boolean	Restricts user from modifying device attributes
`limitCommands`	boolean	Prevents user from sending unsupported commands
`fixedEmail`	boolean	Locks the email field to avoid changes
`poiLayer`	string,null	External POI layer configured for the user
`attributes`	object	Additional custom user attributes

infoCódigos de estado

Código	Nombre	Descripción
200	OK	La petición se completó correctamente.
202	Accepted	La operación quedó en cola (por ejemplo, comandos).
204	No Content	Operación exitosa sin cuerpo de respuesta.
400	Bad Request	Parámetros inválidos o faltantes.
401	Unauthorized	Credenciales ausentes o inválidas.
403	Forbidden	Autenticado, pero sin permisos suficientes.
404	Not Found	El recurso no existe.
405	Method Not Allowed	Método HTTP no soportado en la ruta.
415	Unsupported Media Type	Tipo de contenido no soportado.
500	Server Error	Error interno del servicio.