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.
Erlebnisse und Zuhause › Smart Home API
LOKALE HTTP-API · PRO 2.0
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.
Nur im lokalen Netzwerk. Kein Cloud-Konto, keine Portfreigabe. iPhone, iPad, Mac und Android.

Einstellungen → Automation → Smart Home. Aktiviere das Hosting und bei Bedarf den Hintergrundmodus, damit es auch bei gesperrtem Smartphone läuft.
Die App zeigt deine Adresse, etwa http://192.168.1.20:58761/huedynamic, und einen privaten API-Schlüssel.
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.
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 | {} |
| GET | /v1/disco/presets | Disco-Voreinstellungen, die per presetId starten | — |
| POST | /v1/disco/start | Live Disco in einem Raum starten – mit Voreinstellung, Auto-DJ oder den aktuellen Einstellungen | {"roomId":"…","presetId":"…"} |
| POST | /v1/disco/stop | Live Disco stoppen | {} |
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
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.
secrets.yamlcode, nicht des Meldungstexts# 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: "{}" Nur Geräte im selben WLAN- oder Ethernet-Netzwerk können sich verbinden. Keine Cloud, kein Konto. Gib den Port niemals zum Internet frei.
Standardmäßig braucht jede Anfrage deinen privaten Schlüssel. Erneuere ihn jederzeit; die Kindersicherung gilt auch für Fernbefehle.
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.
Lieber per Stimme? Starte Erlebnisse, Wiedergabelisten und Disco mit Auto-DJ per Siri oder verbinde sie in Apple Kurzbefehle.
Ja, die Smart Home API gehört zu Pro 2.0.
Du brauchst keine. Der integrierte rest_command von Home Assistant kommuniziert direkt mit hueDynamic, wie oben gezeigt.
Nein. Die API akzeptiert nur Geräte im lokalen Netzwerk. Anfragen sind unverschlüsselt; deshalb darf sie niemals im Internet zugänglich sein.
Kopiere die neue URL aus den Einstellungen und aktualisiere deine Integrationen. Eine feste IP im Router vermeidet das.
Ja. POST /v1/disco/start öffnet den Disco-Tab und startet Live Disco in einem Raum. Mit einer "presetId" aus GET /v1/disco/presets läuft dieses Genre oder deine eigene Voreinstellung, mit "autoDj": true wählt der Auto-DJ die Genre-Voreinstellungen passend zur Musik. Ohne beides laufen deine aktuellen Disco-Einstellungen mit ausgeschaltetem Auto-DJ. Disco hört über das Mikrofon zu, daher muss hueDynamic auf dem Bildschirm geöffnet sein.
EINFACH ALLES FÜR HUE-LAMPEN
Kostenlos auf iPhone, iPad, Mac und Android ausprobieren. Eine Philips Hue Bridge ist erforderlich.