API Reference

REST API documentation for the Iconet Gateway.

Base URL

http://<gateway-ip>/api/v1

All API requests require a Bearer token:

Authorization: Bearer <your-api-token>

Generate a token from Settings → API → Generate Token in the dashboard.

GET /api/v1/devices

Returns a list of all configured devices.

GET /api/v1/devices/:id

Returns the current status of a specific device.

POST /api/v1/devices/:id/command
Content-Type: application/json

{
  "action": "set",
  "value": 75
}

GET /api/v1/scenes

POST /api/v1/scenes/:id/activate

For real-time updates, connect to the WebSocket endpoint:

ws://<gateway-ip>/api/v1/ws

Events are pushed as JSON messages when device states change.