Referencia de API
Documentación de la API REST del Iconet Gateway.
URL Base
http://<ip-del-gateway>/api/v1
Autenticación
Todas las solicitudes API requieren un token Bearer:
Authorization: Bearer <tu-token-api>
Genera un token desde Ajustes → API → Generar Token en el panel de control.
Endpoints
Obtener Todos los Dispositivos
GET /api/v1/devices
Devuelve una lista de todos los dispositivos configurados.
Obtener Estado del Dispositivo
GET /api/v1/devices/:id
Devuelve el estado actual de un dispositivo específico.
Controlar Dispositivo
POST /api/v1/devices/:id/command
Content-Type: application/json
{
"action": "set",
"value": 75
}
Listar Escenas
GET /api/v1/scenes
Activar Escena
POST /api/v1/scenes/:id/activate
API WebSocket
Para actualizaciones en tiempo real, conéctate al endpoint WebSocket:
ws://<ip-del-gateway>/api/v1/ws
Los eventos se envían como mensajes JSON cuando cambian los estados de los dispositivos.
Límites de Tasa
- API REST: 100 solicitudes/minuto
- WebSocket: Ilimitado (basado en eventos)