API HTTP LOCAL · PRO 2.0

Controla hueDynamic desde tu hogar inteligente.

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.

Ver los endpoints Configurar Home Assistant

Solo red local. Sin cuenta en la nube ni reenvío de puertos. iPhone, iPad, Mac y Android.

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

Funciona con la central que ya usas

Home Assistantrest_command, scripts y automatizaciones
Node-REDnodo http request
Homeytarjetas Flow de peticiones HTTP
HubitatHTTP POST desde Rule Machine
openHABbinding HTTP o reglas
Stream Deck y scriptscualquier herramienta que envíe HTTP

Actívala en menos de un minuto

1
Activar alojamiento
Ajustes → Automatización → Smart Home. Activa el alojamiento y el modo en segundo plano si quieres que funcione con el teléfono bloqueado.
2
Copiar la URL y la clave
La app muestra tu dirección, como http://192.168.1.20:58761/huedynamic, y una clave API privada.
3
Obtener los ID
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.

Qué puedes llamar

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	{}

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

Dos bloques YAML y listo.

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.

Guarda la clave en secrets.yaml
Basa las condiciones en code, no en el texto del mensaje
Usa las mismas llamadas desde Node-RED, Homey o 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: "{}"

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.

Tu clave, tus reglas

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.

Funciona en segundo plano

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.

También Siri y Atajos

¿Prefieres la voz? Inicia experiencias y listas con Siri o encadénalas en Atajos de Apple.

Preguntas

¿Necesito Pro?

Sí, la API Smart Home forma parte de Pro 2.0.

¿Hay una integración para Home Assistant?

No necesitas una. El rest_command integrado de Home Assistant se comunica directamente con hueDynamic, como se muestra arriba.

¿Puedo controlarlo desde fuera de casa?

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.

¿Qué pasa si cambia la IP de mi teléfono?

Copia la nueva URL de Ajustes y actualiza tus integraciones. Asignar una IP fija al dispositivo en el router evita el problema.

Más por descubrir

Listas de reproducción →Encadena experiencias y repítelas.Cada habitación →Un efecto distinto en cada habitación.Noche de cine →Luces que siguen la pantalla.Interruptores y sensores →Haz más con cada botón.

TODO LO QUE NECESITAS PARA TUS LUCES HUE

Haz que hueDynamic forme parte de tu hogar inteligente.

App Store Google Play

Prueba gratis en iPhone, iPad, Mac y Android. Requiere un puente Philips Hue.