hueDynamic SMART HOME-API Download de app
NL

Ervaringen en thuis Smart Home-API

LOKALE HTTP-API · PRO 2.0

Bedien hueDynamic vanuit je smarthome.

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.

Bekijk de eindpunten Home Assistant instellen

Alleen je lokale netwerk. Geen cloudaccount, geen poortdoorschakeling. iPhone, iPad, Mac en Android.

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

Werkt met de hub die je al gebruikt

  • Home Assistantrest_command, scripts en automatiseringen
  • Node-REDhttp request-node
  • HomeyFlow-kaarten voor HTTP-verzoeken
  • HubitatHTTP POST vanuit Rule Machine
  • openHABHTTP-binding of regels
  • Stream Deck en scriptselke tool die HTTP kan sturen

Zet het aan in minder dan een minuut

  1. 1

    Hosting inschakelen

    Instellingen → Automatisering → Smart Home. Zet hosting aan en schakel de achtergrondmodus in als het ook moet werken wanneer je telefoon vergrendeld is.

  2. 2

    URL en sleutel kopiëren

    De app toont je adres, bijvoorbeeld http://192.168.1.20:58761/huedynamic, en een privésleutel voor de API.

  3. 3

    Je ID’s ophalen

    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.

Wat je kunt aanroepen

De paden volgen je basis-URL. POST-verzoeken sturen JSON met Content-Type: application/json en de header Authorization: Bearer <API_KEY>.

METHODEPADFUNCTIEVOORBEELDINHOUD
GET/v1/statusStatus van app en bridge—
GET/v1/roomsKamer-ID’s en namen—
GET/v1/lightsLamp-ID’s en namen—
POST/v1/rooms/{id}/powerEen kamer aan- of uitzetten{"on":true}
POST/v1/rooms/{id}/brightnessHelderheid van een kamer instellen{"brightnessPercent":75}
POST/v1/rooms/{id}/colourEen kleur instellen{"hexColour":"#FF8800","brightnessPercent":100}
POST/v1/rooms/{id}/whiteEen wittemperatuur instellen{"mirek":250,"brightnessPercent":100}
POST/v1/lights/{id}/powerDezelfde bediening voor één lamp{"on":false}
GET/v1/modesErvaringen en scènes die je kunt starten—
GET/v1/running-modesWat er nu actief is—
POST/v1/modes/startEen ervaring in een kamer starten{"modeId":"…","roomId":"…","durationMinutes":0}
POST/v1/rooms/{id}/modes/stopAlles in één kamer stoppen{}
POST/v1/modes/stop-allAlle actieve effecten stoppen{}
GET/v1/playlistsOpgeslagen afspeellijsten—
POST/v1/playlists/startEen afspeellijst starten, eventueel in een andere kamer{"playlistId":"…","roomId":"…"}
POST/v1/playlist-sessions/{id}/nextNaar het volgende item gaan{}
POST/v1/playlist-sessions/{id}/stopAfspeellijst stoppen en lampen herstellen{}
GET/v1/motion-triggersIngestelde bewegingstriggers—
POST/v1/motion-monitoring/startBewegingstriggers activeren{}
POST/v1/motion-monitoring/stopBewegingstriggers 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

Twee blokken YAML en je bent klaar.

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.

  • Bewaar de sleutel in secrets.yaml
  • Gebruik code voor voorwaarden, niet de meldingstekst
  • Gebruik dezelfde aanroepen vanuit Node-RED, Homey of 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: "{}"

Blijft in je huis

Alleen apparaten op hetzelfde wifi- of ethernetnetwerk kunnen verbinden. Geen cloud, geen account. Stuur de poort nooit door naar internet.

Jouw sleutel, jouw regels

Elk verzoek heeft standaard je privésleutel nodig. Genereer die op elk moment opnieuw; het kinderslot geldt ook voor externe commando’s.

Werkt op de achtergrond

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.

Ook Siri en Opdrachten

Liever met je stem? Start ervaringen en afspeellijsten met Siri of verbind ze in Apple Opdrachten.

Vragen

Heb ik Pro nodig?

Ja, de Smart Home-API hoort bij Pro 2.0.

Is er een Home Assistant-integratie?

Die heb je niet nodig. De ingebouwde rest_command van Home Assistant praat rechtstreeks met hueDynamic, zoals hierboven.

Kan ik het van buiten mijn huis bedienen?

Nee. De API accepteert alleen apparaten op je lokale netwerk. Verzoeken zijn niet versleuteld, dus stel de API nooit bloot aan internet.

Wat als het IP-adres van mijn telefoon verandert?

Kopieer de nieuwe URL uit Instellingen en werk je integraties bij. Een vast IP voor het apparaat in je router voorkomt dit.

Meer om te ontdekken

Afspeellijsten →Verbind ervaringen en herhaal ze.Elke kamer →Een ander effect in elke kamer.Filmavond →Lampen die het scherm volgen.Schakelaars en sensoren →Laat elke knop meer doen.

ECHT ALLES VOOR HUE-LAMPEN

Maak hueDynamic onderdeel van je smarthome.

App Store Google Play

Gratis uitproberen op iPhone, iPad, Mac en Android. Een Philips Hue Bridge is vereist.