Dispositivos y telemetría

Identidad de un equipo

Campo	Qué es
deviceId	MAC de la interfaz de red, en minúsculas y sin separadores (a4cf12bb73d2). Identificador único del equipo.
partNumber	Serial del modelo (catálogo de tipos): resuelve el tipo de dispositivo.
deviceType	Familia: UDR (pintura), UTA (depósitos), UDO (dosificación), UNE (transacciones/stock). Nunca viaja en el topic ni en el payload: lo resuelve la plataforma.

Listar la flota

curl "https://api.linter-iot-stg.icent.digital/v1/devices?limit=50" \
  -H "Authorization: Bearer lit_…"

Parámetros útiles: deviceType=UDR,UTA, status=ACTIVE, search=<texto>, clientId=…, paginación limit/offset (máx. 500 por página).

Cada elemento incluye, además de la identidad:

• connectivity: online / offline (ventana de 10 minutos desde la última lectura).
• alertSeverity: critical / warning si el equipo tiene alertas activas.
• location: { lat, lng, source } cuando el equipo tiene SIM — la posición se resuelve del lado del servidor (hoy simulada de forma determinista; mañana, API del operador con el mismo contrato).

Detalle y lecturas

curl https://api.linter-iot-stg.icent.digital/v1/devices/<id> \
  -H "Authorization: Bearer lit_…"

curl "https://api.linter-iot-stg.icent.digital/v1/devices/<id>/telemetry?limit=20" \
  -H "Authorization: Bearer lit_…"

La telemetría cruda de un rango temporal (para gráficas) está en GET /v1/telemetry?deviceId=<mac>&from=<iso>&to=<iso> y el volumen agregado de las últimas 24 h en GET /v1/telemetry/count24h.

Catálogo de tipos

Los modelos (part number → tipo, nombre comercial, foto, vídeos, configuración de vistas y reglas de alerta) se gestionan en /v1/device-models (ROOT). Añadir un modelo nuevo permite que sus equipos entren solos al sistema.