Blijft in je huis
Alleen apparaten op hetzelfde wifi- of ethernetnetwerk kunnen verbinden. Geen cloud, geen account. Stuur de poort nooit door naar internet.
Ervaringen en thuis › Smart Home-API
LOKALE HTTP-API · PRO 2.0
Zet de Smart Home-API aan en hueDynamic wordt onderdeel van Home Assistant, Node-RED, Homey of alles wat HTTP-verzoeken kan sturen. Start ervaringen en afspeellijsten, stel kleuren in en gebruik bewegingstriggers vanuit je eigen automatiseringen, via je thuisnetwerk.
Alleen je lokale netwerk. Geen cloudaccount, geen poortdoorschakeling. iPhone, iPad, Mac en Android.

Instellingen → Automatisering → Smart Home. Zet hosting aan en schakel de achtergrondmodus in als het ook moet werken wanneer je telefoon vergrendeld is.
De app toont je adres, bijvoorbeeld http://192.168.1.20:58761/huedynamic, en een privésleutel voor de API.
Kies kamers en ervaringen in de integratie-ID-kiezer of roep GET /v1/rooms en /v1/modes aan. De app maakt zelfs het curl-commando voor je.
De paden volgen je basis-URL. POST-verzoeken sturen JSON met Content-Type: application/json en de header Authorization: Bearer <API_KEY>.
| METHODE | PAD | FUNCTIE | VOORBEELDINHOUD |
|---|---|---|---|
| GET | /v1/status | Status van app en bridge | — |
| GET | /v1/rooms | Kamer-ID’s en namen | — |
| GET | /v1/lights | Lamp-ID’s en namen | — |
| POST | /v1/rooms/{id}/power | Een kamer aan- of uitzetten | {"on":true} |
| POST | /v1/rooms/{id}/brightness | Helderheid van een kamer instellen | {"brightnessPercent":75} |
| POST | /v1/rooms/{id}/colour | Een kleur instellen | {"hexColour":"#FF8800","brightnessPercent":100} |
| POST | /v1/rooms/{id}/white | Een wittemperatuur instellen | {"mirek":250,"brightnessPercent":100} |
| POST | /v1/lights/{id}/power | Dezelfde bediening voor één lamp | {"on":false} |
| GET | /v1/modes | Ervaringen en scènes die je kunt starten | — |
| GET | /v1/running-modes | Wat er nu actief is | — |
| POST | /v1/modes/start | Een ervaring in een kamer starten | {"modeId":"…","roomId":"…","durationMinutes":0} |
| POST | /v1/rooms/{id}/modes/stop | Alles in één kamer stoppen | {} |
| POST | /v1/modes/stop-all | Alle actieve effecten stoppen | {} |
| GET | /v1/playlists | Opgeslagen afspeellijsten | — |
| POST | /v1/playlists/start | Een afspeellijst starten, eventueel in een andere kamer | {"playlistId":"…","roomId":"…"} |
| POST | /v1/playlist-sessions/{id}/next | Naar het volgende item gaan | {} |
| POST | /v1/playlist-sessions/{id}/stop | Afspeellijst stoppen en lampen herstellen | {} |
| GET | /v1/motion-triggers | Ingestelde bewegingstriggers | — |
| POST | /v1/motion-monitoring/start | Bewegingstriggers activeren | {} |
| POST | /v1/motion-monitoring/stop | Bewegingstriggers deactiveren | {} |
Elk antwoord bevat success, een vaste code en een message. Helderheid en snelheid voor ervaringen lopen van 1–200%; wittemperatuur is 153–500 mirek; duur 0 betekent doorgaan tot stoppen.
HOME ASSISTANT
Voeg een rest_command voor hueDynamic toe en roep die aan vanuit een automatisering, script of dashboardknop. Haardvuur bij zonsondergang, Oceaanwerelden als het bad volloopt, een schrikmoment bij de deurbel.
secrets.yamlcode voor voorwaarden, niet de meldingstekst# 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: "{}" Alleen apparaten op hetzelfde wifi- of ethernetnetwerk kunnen verbinden. Geen cloud, geen account. Stuur de poort nooit door naar internet.
Elk verzoek heeft standaard je privésleutel nodig. Genereer die op elk moment opnieuw; het kinderslot geldt ook voor externe commando’s.
De optionele achtergrondmodus houdt de API beschikbaar als je iPhone vergrendeld is of je Android in je zak zit. Houd de app op Mac open.
Liever met je stem? Start ervaringen en afspeellijsten met Siri of verbind ze in Apple Opdrachten.
Ja, de Smart Home-API hoort bij Pro 2.0.
Die heb je niet nodig. De ingebouwde rest_command van Home Assistant praat rechtstreeks met hueDynamic, zoals hierboven.
Nee. De API accepteert alleen apparaten op je lokale netwerk. Verzoeken zijn niet versleuteld, dus stel de API nooit bloot aan internet.
Kopieer de nieuwe URL uit Instellingen en werk je integraties bij. Een vast IP voor het apparaat in je router voorkomt dit.
ECHT ALLES VOOR HUE-LAMPEN
Gratis uitproberen op iPhone, iPad, Mac en Android. Een Philips Hue Bridge is vereist.