API HTTP LOCALE · PRO 2.0

Contrôlez hueDynamic depuis votre maison connectée.

Activez l’API Smart Home pour intégrer hueDynamic à Home Assistant, Node-RED, Homey ou tout outil capable d’envoyer une requête HTTP. Lancez ambiances et listes, réglez les couleurs et utilisez les déclencheurs de mouvement dans vos automatisations, sur votre réseau domestique.

Voir les points d’accès Configuration Home Assistant

Réseau local uniquement. Sans compte cloud ni redirection de port. iPhone, iPad, Mac et Android.

$ curl -X POST …/huedynamic/v1/modes/start
{"modeId":"fireplace","roomId":"lounge"}
{"success":true,"code":"ok","message":"Started"}

Avec la centrale que vous utilisez déjà

Home Assistantrest_command, scripts et automatisations
Node-REDnœud http request
Homeycartes Flow de requête HTTP
HubitatHTTP POST depuis Rule Machine
openHABbinding HTTP ou règles
Stream Deck et scriptstout outil capable d’envoyer du HTTP

Activez-la en moins d’une minute

1
Activer l’hébergement
Réglages → Automatisation → Smart Home. Activez l’hébergement et le mode arrière-plan si vous souhaitez un fonctionnement quand le téléphone est verrouillé.
2
Copier l’URL et la clé
L’app affiche votre adresse, par exemple http://192.168.1.20:58761/huedynamic, et une clé API privée.
3
Récupérer les identifiants
Choisissez pièces et ambiances dans le sélecteur d’identifiants d’intégration ou appelez GET /v1/rooms et /v1/modes. L’app prépare même la commande curl.

Les appels disponibles

Les chemins suivent votre URL de base. Les requêtes POST envoient du JSON avec Content-Type: application/json et l’en-tête Authorization: Bearer <API_KEY>.

MÉTHODE	CHEMIN	FONCTION	CORPS D’EXEMPLE
GET	/v1/status	État de l’app et du pont	—
GET	/v1/rooms	Identifiants et noms des pièces	—
GET	/v1/lights	Identifiants et noms des lumières	—
POST	/v1/rooms/{id}/power	Allumer ou éteindre une pièce	{"on":true}
POST	/v1/rooms/{id}/brightness	Régler la luminosité d’une pièce	{"brightnessPercent":75}
POST	/v1/rooms/{id}/colour	Définir une couleur	{"hexColour":"#FF8800","brightnessPercent":100}
POST	/v1/rooms/{id}/white	Définir la température du blanc	{"mirek":250,"brightnessPercent":100}
POST	/v1/lights/{id}/power	Les mêmes commandes pour une seule lumière	{"on":false}
GET	/v1/modes	Ambiances et scènes disponibles	—
GET	/v1/running-modes	Ce qui est en cours	—
POST	/v1/modes/start	Lancer une ambiance dans une pièce	{"modeId":"…","roomId":"…","durationMinutes":0}
POST	/v1/rooms/{id}/modes/stop	Tout arrêter dans une pièce	{}
POST	/v1/modes/stop-all	Arrêter tous les effets en cours	{}
GET	/v1/playlists	Listes de lecture enregistrées	—
POST	/v1/playlists/start	Lancer une liste, éventuellement dans une autre pièce	{"playlistId":"…","roomId":"…"}
POST	/v1/playlist-sessions/{id}/next	Passer à l’élément suivant	{}
POST	/v1/playlist-sessions/{id}/stop	Arrêter la liste et rétablir les lumières	{}
GET	/v1/motion-triggers	Déclencheurs de mouvement configurés	—
POST	/v1/motion-monitoring/start	Armer les déclencheurs de mouvement	{}
POST	/v1/motion-monitoring/stop	Désarmer les déclencheurs de mouvement	{}

Chaque réponse comprend success, un code stable et un message. Luminosité et vitesse des ambiances vont de 1 à 200 %, la température du blanc de 153 à 500 mirek ; une durée de 0 signifie jusqu’à l’arrêt.

HOME ASSISTANT

Deux blocs YAML, et c’est prêt.

Ajoutez un rest_command pour hueDynamic, puis appelez-le depuis une automatisation, un script ou un bouton de tableau de bord. Feu de cheminée au coucher du soleil, Mondes océaniques pendant le bain, frayeur à la sonnette.

Conservez la clé dans secrets.yaml
Basez les conditions sur code, pas sur le texte du message
Utilisez les mêmes appels depuis Node-RED, Homey ou Hubitat

# configuration.yaml
rest_command:
  huedynamic_start:
    url: "http://192.168.1.20:58761/huedynamic/v1/modes/start"
    method: POST
    headers:
      Authorization: !secret huedynamic_auth   # "Bearer <API_KEY>"
    content_type: "application/json"
    payload: '{"modeId":"{{ mode }}","roomId":"{{ room }}"}'

  huedynamic_stop_all:
    url: "http://192.168.1.20:58761/huedynamic/v1/modes/stop-all"
    method: POST
    headers:
      Authorization: !secret huedynamic_auth
    content_type: "application/json"
    payload: "{}"

Reste chez vous

Seuls les appareils du même réseau Wi-Fi ou Ethernet peuvent se connecter. Sans cloud ni compte. Ne redirigez jamais le port vers internet.

Votre clé, vos règles

Chaque requête nécessite votre clé privée par défaut. Régénérez-la à tout moment ; le verrouillage enfant s’applique aussi aux commandes à distance.

Fonctionne en arrière-plan

Le mode arrière-plan optionnel garde l’API disponible quand votre iPhone est verrouillé ou votre Android dans la poche. Sur Mac, gardez l’app ouverte.

Siri et Raccourcis aussi

Vous préférez la voix ? Lancez ambiances et listes avec Siri ou enchaînez-les dans Raccourcis d’Apple.

Questions

Faut-il Pro ?

Oui, l’API Smart Home fait partie de Pro 2.0.

Existe-t-il une intégration Home Assistant ?

Ce n’est pas nécessaire. Le rest_command intégré à Home Assistant communique directement avec hueDynamic, comme ci-dessus.

Puis-je le contrôler hors de chez moi ?

Non. L’API accepte uniquement les appareils de votre réseau local. Les requêtes ne sont pas chiffrées : elle ne doit jamais être exposée à internet.

Que faire si l’adresse IP de mon téléphone change ?

Copiez la nouvelle URL dans les réglages et mettez vos intégrations à jour. Une IP fixe attribuée par votre routeur évite ce problème.

À découvrir aussi

Listes de lecture →Enchaînez les ambiances en boucle.Chaque pièce →Un effet différent dans chaque pièce.Soirée cinéma →Des lumières qui suivent l’écran.Interrupteurs et détecteurs →Faites-en plus avec chaque bouton.

ABSOLUMENT TOUT POUR VOS LUMIÈRES HUE

Intégrez hueDynamic à votre maison connectée.

App Store Google Play

Essai gratuit sur iPhone, iPad, Mac et Android. Un pont Philips Hue est nécessaire.