API de dispositivos
API de Dispositivos
Gestiona tus dispositivos programáticamente con la API de Dispositivos.
Listar dispositivos
`` GET /v1/devices ``
Parámetros de consulta:
page— Número de página (por defecto: 1)limit— Elementos por página (por defecto: 20, máx.: 100)status— Filtrar por estado:online,offlinestore_id— Filtrar por tiendatag— Filtrar por etiqueta
Respuesta: ``json { "success": true, "data": [ { "id": "dev_abc123", "name": "Lobby Screen 1", "status": "online", "type": "TV", "platform": "android", "store_id": "store_xyz", "last_heartbeat": "2025-01-15T10:30:00Z", "player_version": "1.5.67", "tags": ["lobby", "welcome"] } ] } ``
Obtener detalle de un dispositivo
`` GET /v1/devices/:id ``
Devuelve la información completa del dispositivo, incluyendo métricas de hardware, lista de reproducción actual y configuración.
Actualizar dispositivo
`` PATCH /v1/devices/:id ``
Cuerpo de la petición: ``json { "name": "Updated Name", "store_id": "store_new", "tags": ["updated-tag"], "orientation": "portrait" } ``
Enviar comando
`` POST /v1/devices/:id/commands ``
Cuerpo de la petición: ``json { "command": "REFRESH" } ``
Comandos disponibles: REFRESH, REBOOT, APP_RESTART, UPDATE_CHECK
Usa el filtro status para identificar rápidamente los dispositivos offline en scripts de monitorización automatizados.
Eliminar dispositivo
`` DELETE /v1/devices/:id ``
Elimina el dispositivo de tu organización. El dispositivo físico tendrá que volver a emparejarse.
Datos de heartbeat del dispositivo
`` GET /v1/devices/:id/heartbeats ``
Parámetros de consulta:
from— Fecha de inicio (ISO 8601)to— Fecha de fin (ISO 8601)interval— Intervalo de agregación:minute,hour,day
Devuelve datos históricos de heartbeat, incluyendo CPU, memoria, disco, temperatura y señal Wi-Fi.
El endpoint DELETE elimina un dispositivo de forma permanente. Esta acción no se puede deshacer. El dispositivo mostrará la pantalla de emparejamiento y tendrá que volver a emparejarse.