Référence API

URL de Base

http://<ip-de-la-passerelle>/api/v1

Authentification

Toutes les requêtes API nécessitent un token Bearer :

Authorization: Bearer <votre-token-api>

Générez un token depuis Paramètres → API → Générer un Token dans le tableau de bord.

Endpoints

Obtenir Tous les Appareils

GET /api/v1/devices

Retourne une liste de tous les appareils configurés.

Obtenir l'État d'un Appareil

GET /api/v1/devices/:id

Retourne l'état actuel d'un appareil spécifique.

Contrôler un Appareil

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

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

Lister les Scènes

GET /api/v1/scenes

Activer une Scène

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

API WebSocket

Pour les mises à jour en temps réel, connectez-vous à l'endpoint WebSocket :

ws://<ip-de-la-passerelle>/api/v1/ws

Les événements sont envoyés sous forme de messages JSON lorsque les états des appareils changent.

Limites de Taux

• API REST : 100 requêtes/minute
• WebSocket : Illimité (basé sur les événements)