LOKALE HTTP-API · PRO 2.0

Steuere hueDynamic aus deinem Smart Home.

Aktiviere die Smart Home API und hueDynamic wird Teil von Home Assistant, Node-RED, Homey oder jedem Tool, das HTTP-Anfragen senden kann. Starte Erlebnisse und Wiedergabelisten, setze Farben und nutze Bewegungsauslöser in deinen Automationen — alles im Heimnetzwerk.

Endpunkte ansehen Home Assistant einrichten

Nur im lokalen Netzwerk. Kein Cloud-Konto, keine Portfreigabe. iPhone, iPad, Mac und Android.

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

Mit der Zentrale, die du schon nutzt

Home Assistantrest_command, Skripte und Automationen
Node-REDhttp request-Knoten
HomeyFlow-Karten für HTTP-Anfragen
HubitatHTTP POST über Rule Machine
openHABHTTP-Binding oder Regeln
Stream Deck und Skriptejedes Tool, das HTTP senden kann

In weniger als einer Minute startklar

1
Hosting aktivieren
Einstellungen → Automation → Smart Home. Aktiviere das Hosting und bei Bedarf den Hintergrundmodus, damit es auch bei gesperrtem Smartphone läuft.
2
URL und Schlüssel kopieren
Die App zeigt deine Adresse, etwa http://192.168.1.20:58761/huedynamic, und einen privaten API-Schlüssel.
3
IDs abrufen
Wähle Räume und Erlebnisse in der Auswahl für Integrations-IDs oder rufe GET /v1/rooms und /v1/modes auf. Die App erstellt sogar den curl-Befehl für dich.

Verfügbare Aufrufe

Die Pfade folgen deiner Basis-URL. POST-Anfragen senden JSON mit Content-Type: application/json und dem Header Authorization: Bearer <API_KEY>.

METHODE	PFAD	FUNKTION	BEISPIELINHALT
GET	/v1/status	App- und Bridge-Status	—
GET	/v1/rooms	Raum-IDs und Namen	—
GET	/v1/lights	Licht-IDs und Namen	—
POST	/v1/rooms/{id}/power	Raum ein- oder ausschalten	{"on":true}
POST	/v1/rooms/{id}/brightness	Raumhelligkeit einstellen	{"brightnessPercent":75}
POST	/v1/rooms/{id}/colour	Farbe einstellen	{"hexColour":"#FF8800","brightnessPercent":100}
POST	/v1/rooms/{id}/white	Weißtemperatur einstellen	{"mirek":250,"brightnessPercent":100}
POST	/v1/lights/{id}/power	Dieselben Regler für ein einzelnes Licht	{"on":false}
GET	/v1/modes	Startbare Erlebnisse und Szenen	—
GET	/v1/running-modes	Was gerade läuft	—
POST	/v1/modes/start	Erlebnis in einem Raum starten	{"modeId":"…","roomId":"…","durationMinutes":0}
POST	/v1/rooms/{id}/modes/stop	Alles in einem Raum stoppen	{}
POST	/v1/modes/stop-all	Alle laufenden Effekte stoppen	{}
GET	/v1/playlists	Gespeicherte Wiedergabelisten	—
POST	/v1/playlists/start	Wiedergabeliste starten, optional in einem anderen Raum	{"playlistId":"…","roomId":"…"}
POST	/v1/playlist-sessions/{id}/next	Zum nächsten Eintrag springen	{}
POST	/v1/playlist-sessions/{id}/stop	Wiedergabeliste stoppen und Lichter wiederherstellen	{}
GET	/v1/motion-triggers	Konfigurierte Bewegungsauslöser	—
POST	/v1/motion-monitoring/start	Bewegungsauslöser aktivieren	{}
POST	/v1/motion-monitoring/stop	Bewegungsauslöser deaktivieren	{}

Jede Antwort enthält success, einen stabilen code und eine message. Helligkeit und Geschwindigkeit für Erlebnisse reichen von 1–200 %, Weißtemperatur von 153–500 mirek; Dauer 0 bedeutet bis zum Stoppen.

HOME ASSISTANT

Zwei YAML-Blöcke, fertig.

Füge einen rest_command für hueDynamic hinzu und rufe ihn aus einer Automation, einem Skript oder einem Dashboard-Button auf. Kaminfeuer bei Sonnenuntergang, Ozeanwelten beim Baden, ein Schrecken beim Klingeln.

Speichere den Schlüssel in secrets.yaml
Verzweige anhand von code, nicht des Meldungstexts
Nutze dieselben Aufrufe aus Node-RED, Homey oder 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: "{}"

Bleibt bei dir zu Hause

Nur Geräte im selben WLAN- oder Ethernet-Netzwerk können sich verbinden. Keine Cloud, kein Konto. Gib den Port niemals zum Internet frei.

Dein Schlüssel, deine Regeln

Standardmäßig braucht jede Anfrage deinen privaten Schlüssel. Erneuere ihn jederzeit; die Kindersicherung gilt auch für Fernbefehle.

Läuft im Hintergrund

Der optionale Hintergrundmodus hält die API verfügbar, wenn dein iPhone gesperrt ist oder dein Android-Smartphone in der Tasche steckt. Lass auf dem Mac die App geöffnet.

Auch Siri und Kurzbefehle

Lieber per Stimme? Starte Erlebnisse und Wiedergabelisten mit Siri oder verbinde sie in Apple Kurzbefehle.

Fragen

Brauche ich Pro?

Ja, die Smart Home API gehört zu Pro 2.0.

Gibt es eine Home Assistant-Integration?

Du brauchst keine. Der integrierte rest_command von Home Assistant kommuniziert direkt mit hueDynamic, wie oben gezeigt.

Kann ich es von außerhalb meines Zuhauses steuern?

Nein. Die API akzeptiert nur Geräte im lokalen Netzwerk. Anfragen sind unverschlüsselt; deshalb darf sie niemals im Internet zugänglich sein.

Was passiert, wenn sich die IP-Adresse meines Smartphones ändert?

Kopiere die neue URL aus den Einstellungen und aktualisiere deine Integrationen. Eine feste IP im Router vermeidet das.

Mehr entdecken

Wiedergabelisten →Erlebnisse verbinden und wiederholen.Jeder Raum →Ein anderer Effekt in jedem Raum.Filmabend →Lichter, die dem Bildschirm folgen.Schalter und Sensoren →Mehr Möglichkeiten für jede Taste.

EINFACH ALLES FÜR HUE-LAMPEN

Mach hueDynamic zum Teil deines Smart Homes.

App Store Google Play

Kostenlos auf iPhone, iPad, Mac und Android ausprobieren. Eine Philips Hue Bridge ist erforderlich.