Domotica hub API gebruiken voor automatisering
Je kent het wel: je hebt een stapel slimme apparaten in huis, van lampen tot thermostaten, en ze doen allemaal hun eigen ding. Handig, maar het voelt ook een beetje als een orkest waar iedereen een ander deuntje speelt.
Een domotica hub is de dirigent die ervoor zorgt dat alles samenwerkt.
Maar wat als je de dirigent een eigen script wilt laten schrijven? Dan kom je al snel uit bij de API van je hub. Het klinkt technisch, maar het is echt de sleutel tot de ultieme vrijheid in je slimme huis.
Een API, of Application Programming Interface, is simpelweg een manier voor jou om rechtstreeks te praten met je domotica hub. Stel je voor dat je hub een digitale butler is. Normaal gesproken geef je hem opdrachten via een knopje in een app. Met de API loop je gewoon de keuken in en zegt: "Hey, maar wat als de temperatuur onder de 18 graden komt en de zon ondergaat, zet dan de verwarming een graadje hoger en de woonkamerlamp aan." Dat is de kracht die een API je geeft.
Waarom zou je je in de API van je hub verdiepen?
Voor de meeste dagelijkse dingen heb je een app genoeg. Je zet een schema voor je verlichting of stelt een temperatuur in. Dat werkt prima.
Maar wat als je iets wilt wat de app niet standaard ondersteunt? Misschien wil je dat je Philips Hue lampen reageren op de data van je Netatmo weersstation, iets waar de Hue-app nooit van heeft gehoord.
Dan is een API je beste vriend. Het is de ultieme manier om je domotica echt persoonlijk te maken. Denk aan de mogelijkheden. Je kunt scripts schrijven die complexere logica volgen dan de standaard "als-dan" regels.
Bijvoorbeeld: als de deurbel gaat en het is na 22:00 uur, check dan of je telefoon in het netwerk is.
Als dat niet zo is, stuur dan een notificatie en zet de Philips Hue lampen in de gang op 100% fel rood. Dit soort koppelingen maakt je slimme huis pas écht slim. Je haalt het maximale uit je investering, of je nu een Homey Pro, Home Assistant of een andere hub hebt.
Het is ook een toekomstbestendige keuze. Fabrikanten stoppen soms met ondersteuning voor hun eigen producten, of een app verdwijnt uit de app store.
Als je via de API werkt, ben je minder afhankelijk. Je kunt de kernfunctionaliteit van je apparaten benutten, zelfs als de officiële app ooit verdwijnt.
Je bouwt een laag die van jou is, niet van de fabrikant. Dat geeft een gevoel van controle dat je niet snel kwijtraakt.
Hoe praat je eigenlijk met je hub? De kern van de zaak
Het werkt allemaal op basis van verzoeken en reacties. Jij stuurt een verzoekje naar een specifiek adres, de API-endpoint genoemd.
Dat verzoek bevat een opdracht, bijvoorbeeld "geef me de status van alle lampen". De hub begrijpt dit en stuurt een antwoord terug, meestal in een standaardformaat dat JSON heet. Dat ziet eruit als een ordelijke lijst met data, makkelijk voor computers om te lezen.
Jij kunt dit dan weer gebruiken in een eigen script of app.
Om dit te kunnen doen, moet je wel een manier hebben om jezelf te identificeren. Je kunt niet zomaar lukraak opdrachten gaan sturen. Daarom gebruiken de meeste hubs een API-sleutel of een token.
Dat is een soort digitaal wachtwoord dat je aanmaakt in de app van je hub. Deze sleutel voeg je toe aan elk verzoek dat je stuurt.
Zo weet de hub zeker dat jij het bent en dat je de juiste rechten hebt.
Zo houd je de boel veilig. Stel je voor dat je een script wilt maken dat de temperatuur in je huis uitleest. Je zou dan naar een endpoint van je hub gaan, bijvoorbeeld iets als `https://api.hubnaam.local/api/v1/temperature`. Je stuurt daar je verzoek naartoe, inclusief je API-sleutel.
De hub denkt: "Ah, dat is Jan, die mag dit weten" en stuurt terug: {"woonkamer": 21.5, "slaapkamer": 18.2}. Jouw script kan hiermee verder. Het is een simpele, krachtige conversatie.
Kies je dirigent: Homey Pro, Home Assistant of iets anders?
Niet elke hub is even open. De een geeft je de sleutels tot het paleis, de ander laat je alleen door het raam kijken.
De bekendste voor de doe-het-zelver is Home Assistant. Dit is een open-source platform dat draait op bijvoorbeeld een Raspberry Pi of een eigen server. Home Assistant is gemaakt voor integratie en heeft een fantastische API.
Je kunt bijna alles uitlezen en aansturen wat in je huis te vinden is.
Het is gratis, maar je moet wel zelf de hardware regelen en de software installeren. De leercurve is wat steiler, maar de beloning is enorme vrijheid. Een andere populaire speler is de Homey Pro.
Dit is een prachtig apparaat van Athom, een Nederlands bedrijf. Homey staat bekend om zijn gebruiksvriendelijkheid en het ecosysteem van "Flows" (regels die je in de app maakt).
Homey heeft ook een API, de zogenaamde Web API. Hiermee kun je devices uitlezen en Flows starten vanuit externe scripts.
De Homey Pro (rond de €400) is een stukje duurder dan een Raspberry Pi, maar je krijgt er een prachtig ontworpen apparaat voor terug dat direct werkt. De API is iets minder diepgaand dan die van Home Assistant, maar voor de meeste doeleinden meer dan voldoende. Wat zijn je opties qua kosten? Een Home Assistant setup kun je al bouwen voor zo'n €60 tot €100 als je een Raspberry Pi 4 en een SD-kaartje hebt.
Daar komen dan nog eventuele extra's bij, zoals een Zigbee USB-stick (zo'n €25) om Zigbee-apparaten aan te sturen. De Homey Pro is dus €400, een eenmalige investering.
Je betaalt voor het gemak en het design. Andere hubs, zoals de Hubitat of een Synology NAS met Docker, zijn ook opties, maar Home Assistant en Homey Pro zijn de meest gangbare keuzes voor de thuisklant die verder wil gaan dan de standaard app. Wil je eerst meer weten over de basis? Lees dan onze complete uitleg over hub techniek.
Aan de slag: een paar concrete stappen
Voordat je begint, moet je weten wat je wilt bereiken. Een vaag plan leidt tot frustratie. Wees specifiek.
"Ik wil dat mijn lampen aangaan als mijn trein vertraging heeft" is een concreet doel. Zoek eerst uit of je hub en de dienst (een trein-app bijvoorbeeld) een API hebben. De documentatie van je hub is je beste vriend, zeker bij een domotica hub backup en herstel.
Zoek op "Home Assistant API" of "Homey Web API" en je vindt alles wat je nodig hebt. Om te testen of je API-aanroep werkt, hoef je geen code te schrijven.
Gebruik een tool zoals Postman of Insomnia. Die programma's laten je eenvoudig API-verzoeken maken.
Je vult het adres in, je voegt je sleutel toe (meestal in de "headers" als "Authorization: Bearer [jouw-sleutel]"), en je klikt op verstuur. Zie je de juiste data terugkomen? Dan weet je dat je verbinding goed is. Dit is een onmisbare stap om jezelf een hoop hoofdpijn te besparen.
Als je verzoek werkt, is het tijd voor de volgende stap: een script. Je kunt elk programmeertaal gebruiken die je wilt, maar Python is een populaire keuze vanwege de eenvoud.
Met een paar regels code kun je je verzoek herhalen en de data verwerken. Bijvoorbeeld, een script dat elke 5 minuten de temperatuur uitleest en die in een bestand opslaat. Of een script dat een e-mail stuurt als de zolderkamer warmer wordt dan 30 graden.
Je bent nu de programmeur van je eigen huis. Als je eenmaal de basis te pakken hebt, kun je combineren.
Gebruik de API van je hub om data te onttrekken en koppel die aan een andere service. Bijvoorbeeld, een script dat de data van je slimme meter uitleest via je Home Assistant API en die vervolgens doorstuurt naar een Google Sheet. Zo houd je een prachtig overzicht van je energieverbruik, of verdiep je in een domotica hub voor warmtepomp integratie. De mogelijkheden zijn eindeloos zodra je de taal van je hub spreekt.
Praktische tips voor een soepele start
Begin klein. Probeer niet meteen een complex systeem te bouwen dat je hele huis bestuurt.
Begin met iets simpels. Lees de status van één enkele lamp uit.
Zet die lamp aan via de API. Als dat lukt, heb je een mentale overwinning en een werkend fundament. Grote projecten zijn vaak projecten die nooit afkomen. Kleine succesjes motiveren om door te gaan.
Veiligheid is cruciaal. Behandel je API-sleutel als je pincode.
Deel hem nooit openbaar, niet op GitHub, niet in een forumreactie. Als je een script online zet, gebruik dan een manier om de sleutel geheim te houden, zoals environment variables. Een sleutel die uitlekt, geeft een kwaadwillende toegang tot je slimme huis.
Wees hier echt streng in, het is je privacy en veiligheid waard. Gebruik de community.
Je bent de eerste die dit probeert, verre van. Er zijn duizenden mensen die precies hetzelfde doen.
Zoek forums op van Home Assistant of Homey, of kijk op Reddit. De kans is groot dat iemand anders al een script heeft geschreven voor wat jij wilt doen. Laat je inspireren en leer van anderen.
Dat scheelt je urenlang pielen. En tot slot, wees geduldig.
Werken met APIs is soms frustrerend. Een typefoutje in een endpoint, een verkeerde sleutel, een update die iets verandert... het hoort erbij.
Maar de voldoening als het werkt is enorm. Je hebt je slimme huis niet alleen slimmer gemaakt, maar je hebt er ook echt grip op gekregen. Dat is het waard.