De HomeWizard lokale API is dé manier om je HomeWizard thuisbatterij en P1 meter slimmer te gebruiken dan alleen via de app. Kort gezegd: met de lokale API kun je realtime data zoals batterijpercentage, verbruik en teruglevering ophalen en gebruiken in je eigen automatiseringen, bijvoorbeeld in Homey of Home Assistant. In 2026 werkt dit via de API v2 (HTTPS + token + realtime updates) en dat is vooral belangrijk omdat de HomeWizard Plug-In Battery alleen via deze nieuwe API goed te gebruiken is.
Concreet kun je hiermee:
- Je batterijstatus realtime uitlezen
- Slimme flows maken op basis van energieverbruik
- Automatisch apparaten aansturen bij overschot of tekort
Het grote voordeel is dat alles lokaal gebeurt, dus snel en zonder afhankelijkheid van externe servers. In deze blog leggen we eerst de praktische basis uit, daarna gaan we dieper in op de techniek en hoe je dit maximaal benut voor een thuisbatterij met stekker.
Wat is de HomeWizard lokale API en waarom is het interessant
De HomeWizard lokale API is een interface waarmee je direct met je apparaten communiceert binnen je eigen netwerk. In plaats van alleen de app te gebruiken, kun je zelf data ophalen en verwerken. Dat klinkt technisch, maar in de praktijk betekent het vooral meer controle.
Voor een thuisbatterij met stekker is dit extra interessant. Je kunt namelijk precies zien wat je batterij doet en daar direct op inspelen. Denk aan situaties waarin je batterij vol raakt en je automatisch apparaten wilt inschakelen, of juist energie wilt besparen als de batterij leegloopt.
Het verschil met de app zit vooral in flexibiliteit. De app laat zien wat er gebeurt, maar met de API kun je er ook echt iets mee doen. Je bouwt als het ware je eigen energie management systeem, afgestemd op jouw huishouden.
Wat veel mensen niet weten: de API werkt lokaal, dus ook zonder internet. Dit maakt het systeem niet alleen sneller, maar ook betrouwbaarder.
API v1 vs API v2: dit moet je weten
HomeWizard heeft twee versies van de API gehad, maar in 2026 is API v2 de standaard. Vooral als je met de thuisbatterij werkt, is dit essentieel om te begrijpen.
API v1 was simpel en werkte via een open endpoint, maar had beperkingen en minder beveiliging. API v2 is een stuk moderner en werkt met HTTPS en een token voor toegang. Ook ondersteunt deze versie realtime updates via WebSockets.
Voor jou betekent dit:
- Betere beveiliging
- Snellere data (bijna realtime)
- Meer mogelijkheden voor automatisering
De Plug-In Battery werkt alleen met API v2. Als je dus serieus met automatisering aan de slag wilt, moet je deze versie gebruiken.
Zo activeer je de HomeWizard lokale API (stap voor stap)
Het activeren van de API is gelukkig eenvoudig en binnen een paar minuten geregeld. Dit is de basis die iedereen kan volgen, ook zonder technische kennis.
Open de HomeWizard app en ga naar de instellingen van je apparaat, bijvoorbeeld de P1 meter of thuisbatterij. Daar vind je de optie “Lokale API”. Zet deze aan en genereer een token.
Vervolgens zoek je het IP-adres van je apparaat op binnen je netwerk. Dit kan via je router of via de app zelf. Zodra je dit hebt, kun je de API benaderen via een URL zoals:
Bij API v2 gebruik je daarnaast een Authorization header met je token. Dit klinkt ingewikkeld, maar veel tools en scripts regelen dit automatisch.
Als je dit eenmaal hebt ingesteld, kun je direct data ophalen uit je HomeWizard systeem.
Welke data kun je uitlezen uit je thuisbatterij
De kracht van de lokale API zit in de data die je beschikbaar krijgt. Dit gaat veel verder dan wat je standaard in de app ziet.
Je kunt onder andere ophalen:
- Batterijpercentage
- Laad- en ontlaadvermogen
- Actueel energieverbruik
- Teruglevering naar het net
Voor de thuisbatterij is vooral de combinatie van deze data interessant. Je ziet niet alleen hoeveel energie je hebt opgeslagen, maar ook hoe snel je batterij wordt gebruikt of geladen.
Hieronder een overzicht van veelgebruikte data:
| Data punt | Wat betekent het |
|---|---|
| State of charge (%) | Hoe vol je batterij is |
| Power (W) | Laden of ontladen in realtime |
| Grid usage (W) | Afname of teruglevering |
| Total consumption | Totaal verbruik |
Met deze gegevens kun je echt slimme keuzes maken in je energiegebruik.
Praktische toepassingen met een thuisbatterij met stekker
Zodra je de API gebruikt, ga je merken dat je veel meer controle krijgt over je energie. Dit is waar het echt interessant wordt voor dagelijks gebruik.
Je kunt bijvoorbeeld automatiseren dat je vaatwasser of wasmachine alleen draait als je batterij voldoende geladen is. Of juist dat apparaten uitschakelen wanneer je batterij onder een bepaald niveau komt.
Ook kun je slim omgaan met zonne-energie. Heb je een overschot? Dan kun je dat direct gebruiken in plaats van terugleveren tegen een lage vergoeding.
Wat je in de praktijk ziet, is dat gebruikers die dit goed instellen vaak meer rendement halen uit hun thuisbatterij. Niet omdat de batterij anders werkt, maar omdat ze slimmer omgaan met de energie eromheen.
Technisch verder: koppelen met Homey en Home Assistant
Voor wie verder wil gaan, ligt hier de echte kracht van de HomeWizard API. Je kunt de data namelijk koppelen aan andere systemen.
In Homey gebruik je bijvoorbeeld HomeyScript of Better Logic om API-data op te halen en te verwerken in flows. In Home Assistant is er zelfs een directe integratie, waardoor je alles visueel kunt beheren.
Hiermee kun je bijvoorbeeld:
- Dynamische energieprijzen meenemen
- Apparaten automatisch prioriteren
- Slimme scenario’s bouwen per dagdeel
Dit is eigenlijk een stap richting een volledig eigen energie management systeem, maar dan zonder dure installaties.
Beperkingen en belangrijke aandachtspunten
Hoewel de lokale API veel mogelijkheden biedt, zijn er ook een paar dingen waar je rekening mee moet houden.
De API geeft alleen actuele data en geen historische gegevens. Als je analyses wilt doen over langere tijd, moet je deze data zelf opslaan.
Daarnaast werkt alles lokaal, wat betekent dat je netwerk stabiel moet zijn. Problemen met wifi of je router kunnen invloed hebben op je automatiseringen.
Ook is het belangrijk om je API-token goed te beveiligen. Geef deze nooit zomaar door en zorg dat je netwerk goed beschermd is.
Tot slot: HomeWizard blijft ontwikkelen. Functies kunnen veranderen of uitbreiden, dus het is slim om updates in de gaten te houden.
HomeWizard lokale API: zo gebruik je hem slim voor je thuisbatterij met stekker
De HomeWizard lokale API is een van de krachtigste tools als je echt het maximale uit je thuisbatterij met stekker wilt halen. Waar de app stopt bij inzicht, begint de API pas echt met controle.
Voor beginners is het al waardevol om simpelweg data uit te lezen en kleine automatiseringen te maken. Voor gevorderden biedt het de mogelijkheid om een compleet slim energiesysteem te bouwen dat inspeelt op verbruik, opslag en zelfs energieprijzen.
De sleutel zit in klein beginnen en stap voor stap uitbreiden. Zodra je ziet wat er mogelijk is, wil je eigenlijk niet meer terug naar alleen de standaard app.