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)
Referencia de API - Iconet — Moderniza tu Sistema Vantage y de Domótica