Se queda en casa
Solo pueden conectarse dispositivos de la misma red Wi-Fi o Ethernet. Sin nube ni cuenta. Nunca expongas el puerto a internet.
Experiencias y hogar › API Smart Home
API HTTP LOCAL · PRO 2.0
Activa la API Smart Home e integra hueDynamic en Home Assistant, Node-RED, Homey o cualquier herramienta que envíe peticiones HTTP. Inicia experiencias y listas, ajusta colores y utiliza desencadenantes de movimiento desde tus automatizaciones, todo por tu red doméstica.
Solo red local. Sin cuenta en la nube ni reenvío de puertos. iPhone, iPad, Mac y Android.

Ajustes → Automatización → Smart Home. Activa el alojamiento y el modo en segundo plano si quieres que funcione con el teléfono bloqueado.
La app muestra tu dirección, como http://192.168.1.20:58761/huedynamic, y una clave API privada.
Elige habitaciones y experiencias en el selector de ID de integración o llama a GET /v1/rooms y /v1/modes. La app incluso crea el comando curl.
Las rutas siguen tu URL base. Las peticiones POST envían JSON con Content-Type: application/json y la cabecera Authorization: Bearer <API_KEY>.
| MÉTODO | RUTA | FUNCIÓN | CUERPO DE EJEMPLO |
|---|---|---|---|
| GET | /v1/status | Estado de la app y del puente | — |
| GET | /v1/rooms | ID y nombres de habitaciones | — |
| GET | /v1/lights | ID y nombres de luces | — |
| POST | /v1/rooms/{id}/power | Encender o apagar una habitación | {"on":true} |
| POST | /v1/rooms/{id}/brightness | Ajustar el brillo de una habitación | {"brightnessPercent":75} |
| POST | /v1/rooms/{id}/colour | Ajustar un color | {"hexColour":"#FF8800","brightnessPercent":100} |
| POST | /v1/rooms/{id}/white | Ajustar la temperatura del blanco | {"mirek":250,"brightnessPercent":100} |
| POST | /v1/lights/{id}/power | Los mismos controles para una luz | {"on":false} |
| GET | /v1/modes | Experiencias y escenas que puedes iniciar | — |
| GET | /v1/running-modes | Qué está funcionando ahora | — |
| POST | /v1/modes/start | Iniciar una experiencia en una habitación | {"modeId":"…","roomId":"…","durationMinutes":0} |
| POST | /v1/rooms/{id}/modes/stop | Detener todo en una habitación | {} |
| POST | /v1/modes/stop-all | Detener todos los efectos activos | {} |
| GET | /v1/playlists | Listas guardadas | — |
| POST | /v1/playlists/start | Iniciar una lista, opcionalmente en otra habitación | {"playlistId":"…","roomId":"…"} |
| POST | /v1/playlist-sessions/{id}/next | Saltar al siguiente elemento | {} |
| POST | /v1/playlist-sessions/{id}/stop | Detener la lista y restaurar las luces | {} |
| GET | /v1/motion-triggers | Desencadenantes de movimiento configurados | — |
| POST | /v1/motion-monitoring/start | Activar desencadenantes de movimiento | {} |
| POST | /v1/motion-monitoring/stop | Desactivar desencadenantes de movimiento | {} |
| GET | /v1/disco/presets | Preajustes de Disco que puedes iniciar con presetId | — |
| POST | /v1/disco/start | Iniciar Live Disco en una habitación con un preajuste, DJ auto o los ajustes actuales | {"roomId":"…","presetId":"…"} |
| POST | /v1/disco/stop | Detener Live Disco | {} |
Cada respuesta incluye success, un code estable y un message. El brillo y la velocidad de las experiencias van de 1 a 200%; la temperatura del blanco es de 153 a 500 mirek; duración 0 significa hasta detenerse.
HOME ASSISTANT
Añade un rest_command para hueDynamic y llámalo desde cualquier automatización, script o botón del panel. Chimenea al atardecer, Mundos oceánicos al llenar la bañera y un susto cuando suena el timbre.
secrets.yamlcode, no en el texto del mensaje# 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: "{}" Solo pueden conectarse dispositivos de la misma red Wi-Fi o Ethernet. Sin nube ni cuenta. Nunca expongas el puerto a internet.
Cada petición necesita tu clave privada por defecto. Regénérala cuando quieras; el bloqueo infantil también se aplica a los comandos remotos.
El modo opcional en segundo plano mantiene la API disponible con el iPhone bloqueado o Android en el bolsillo. En Mac, mantén la app abierta.
¿Prefieres la voz? Inicia experiencias, listas y Disco con DJ auto con Siri o encadénalas en Atajos de Apple.
Sí, la API Smart Home forma parte de Pro 2.0.
No necesitas una. El rest_command integrado de Home Assistant se comunica directamente con hueDynamic, como se muestra arriba.
No. La API solo acepta dispositivos de tu red local y las peticiones no están cifradas, por lo que nunca debe exponerse a internet.
Copia la nueva URL de Ajustes y actualiza tus integraciones. Asignar una IP fija al dispositivo en el router evita el problema.
Sí. POST /v1/disco/start abre la pestaña Disco e inicia Live Disco en una habitación. Añade un "presetId" de GET /v1/disco/presets para reproducir ese género o tu propio preajuste, o "autoDj": true para que el DJ auto elija los preajustes de género según la música. Sin ninguno de los dos, se usan tus ajustes actuales de Disco con el DJ auto desactivado. Disco escucha por el micrófono, así que hueDynamic debe estar abierta en pantalla.
TODO LO QUE NECESITAS PARA TUS LUCES HUE
Prueba gratis en iPhone, iPad, Mac y Android. Requiere un puente Philips Hue.