
API locale Une petite API HTTP sur votre réseau pour Home Assistant, Node‑RED, des scripts et des outils d'installateur. Base `http://iconet.local/api/… Authorization: Bearer ico_…` Créez le jeton dans Réglages › Access (An integration or app) avec les permissions nécessaires. Tous les appels sont en JSON, sur le réseau local uniquement, et consignés dans Activity. Appareils `GET /api/areas pièces Read devices GET /api/entities tous les appareils et leur état Read devices GET /api/entities/{id} un appareil Read devices POST /api/command agir sur un appareil Control devices` Un appareil porte `id`, `entityId` (un alias lisible comme `light.kitchen`), `name`, `domain` (light, cover, climate, lock, sensor, switch…), `area`, `capabilities` et `state`. Pour agir, envoyez l'`id` de l'appareil et l'une de ses capacités : `POST /api/command { "id": "…", "capability": "on_off", "value": true }` Les capacités suivent ce que remonte l'appareil : `on_off` (true/false), `brightness` (0–100), `position` et `tilt` (0–100 pour les volets), `setpoint` (température de consigne), `hvac_mode`, `lock` (lock/unlock), `activate` (scènes et boutons). Événements en direct `GET /api/events server‑sent events Live events` Un flux de changements d'état au fil de l'eau. Pointez un EventSource dessus et gardez l'en‑tête. Automatisations `GET /api/workflows lister Read workflows GET /api/workflows/{id} une automatisation Read workflows PUT /api/workflows/{id} créer ou modifier (activer, désactiver) Change workflows DELETE /api/workflows/{id} supprimer Change workflows POST /api/workflows/{id}/run exécuter maintenant Change workflows GET /api/workflows/log exécutions récentes Read workflows` Une automatisation est un document JSON avec `name`, `enabled` et son `flow` (nœuds et liens). Le plus simple pour obtenir la bonne forme : en créer une dans l'app et la relire avec GET. Historique et météo `GET /api/series?ids=…&keys=…&since=…&until=…&res=… Read trends GET /api/insights Read trends GET /api/weather Read trends` `series` renvoie les séries temporelles des appareils et clés demandés ; `insights` les totaux d'énergie des périodes en cours ; `weather` les prévisions pour l'emplacement de la passerelle. Essayer `curl -H "Authorization: Bearer ico_…" http://iconet.local/api/entities` Home Assistant Un `rest_command` avec le même en‑tête vous donne n'importe quel appareil depuis une automatisation HA ; Réglages › MQTT est la voie la plus complète (tous les appareils découverts automatiquement). Précédent Connecter un client IA Suivant Mises à jour

API locale

Une petite API HTTP sur votre réseau pour Home Assistant, Node‑RED, des scripts et des outils d'installateur.

Base

http://iconet.local/api/…
Authorization: Bearer ico_…

Créez le jeton dans Réglages › Access (An integration or app) avec les permissions nécessaires. Tous les appels sont en JSON, sur le réseau local uniquement, et consignés dans Activity.

Appareils

GET  /api/areas                 pièces                         Read devices
GET  /api/entities              tous les appareils et leur état   Read devices
GET  /api/entities/{id}         un appareil                    Read devices
POST /api/command               agir sur un appareil           Control devices

Un appareil porte id, entityId (un alias lisible comme light.kitchen), name, domain (light, cover, climate, lock, sensor, switch…), area, capabilities et state. Pour agir, envoyez l'id de l'appareil et l'une de ses capacités :

POST /api/command
{ "id": "…", "capability": "on_off", "value": true }

Les capacités suivent ce que remonte l'appareil : on_off (true/false), brightness (0–100), position et tilt (0–100 pour les volets), setpoint (température de consigne), hvac_mode, lock (lock/unlock), activate (scènes et boutons).

Événements en direct

GET /api/events                 server‑sent events             Live events

Un flux de changements d'état au fil de l'eau. Pointez un EventSource dessus et gardez l'en‑tête.

Automatisations

GET    /api/workflows           lister                         Read workflows
GET    /api/workflows/{id}      une automatisation             Read workflows
PUT    /api/workflows/{id}      créer ou modifier (activer, désactiver) Change workflows
DELETE /api/workflows/{id}      supprimer                      Change workflows
POST   /api/workflows/{id}/run  exécuter maintenant            Change workflows
GET    /api/workflows/log       exécutions récentes            Read workflows

Une automatisation est un document JSON avec name, enabled et son flow (nœuds et liens). Le plus simple pour obtenir la bonne forme : en créer une dans l'app et la relire avec GET.

Historique et météo

GET /api/series?ids=…&keys=…&since=…&until=…&res=…     Read trends
GET /api/insights                                       Read trends
GET /api/weather                                        Read trends

series renvoie les séries temporelles des appareils et clés demandés ; insights les totaux d'énergie des périodes en cours ; weather les prévisions pour l'emplacement de la passerelle.

Essayer

curl -H "Authorization: Bearer ico_…" http://iconet.local/api/entities

Home Assistant

Un rest_command avec le même en‑tête vous donne n'importe quel appareil depuis une automatisation HA ; Réglages › MQTT est la voie la plus complète (tous les appareils découverts automatiquement).

Connecter un client IA

Mises à jour