Stekkerbatterij API-koppeling: uitlezen in eigen software

Wat een API-koppeling van een stekkerbatterij is

Een API-koppeling is een manier om de gegevens van je stekkerbatterij buiten de app van de fabrikant te gebruiken: je eigen software, zoals Home Assistant, Homey of een simpel script, vraagt de batterij of de P1-meter rechtstreeks om de laadtoestand, het vermogen en de energietotalen, en slaat die zelf op of toont ze in een eigen dashboard. Bij sommige merken kun je via dezelfde weg ook de modus van de batterij wijzigen. API staat voor de afspraken over hoe die vragen en antwoorden eruitzien; lokaal of via de cloud, gedocumenteerd of door gebruikers uitgezocht.

Dit artikel legt uit welke routes er zijn, wat je er als monitoringmiddel aan hebt, wat de risico's en beperkingen zijn en voor wie het de moeite waard is. Het gaat om uitlezen, loggen en tonen; het bouwen van uitgebreide automatiseringen op basis van dynamische tarieven is een ander onderwerp. Het lezen van de standaardapp staat in de uitleg van de stekkerbatterij-app; het overzicht van alle monitoring vind je in de hub over monitoring van een stekkerbatterij.

Waarom dit belangrijk is

De app van de fabrikant is goed genoeg voor de meeste huishoudens, maar heeft drie grenzen. Hij bewaart de fijne data maar kort, hij toont alleen de eigen batterij en niet de rest van de woning, en hij werkt alleen zolang de servers van de fabrikant bereikbaar zijn. Een eigen koppeling neemt alle drie weg: je bewaart wat je wilt zo lang je wilt, je zet batterij, zonnepanelen, laadpaal en warmtepomp in een overzicht, en een storing bij de fabrikant raakt je dashboard niet.

Wil je eerst het totaalbeeld? Op onze pagina over de stekker thuisbatterij lees je wat het is, voor wie het geschikt is en waar je op let.

Daar staat tegenover dat een koppeling die door gebruikers is uitgezocht na een firmware-update kan breken, en dat sommige fabrikanten het aansturen via een omweg als reden zien om garantievragen kritischer te bekijken. Wie de voordelen wil, moet dus ook de afhankelijkheden begrijpen. Dat is precies waar dit artikel over gaat.

Hoe werkt het

Technisch zijn er drie routes. De eerste is indirect: je koppelt niet de batterij maar de P1-meter, die vrijwel altijd een lokale interface heeft. Daarmee zie je de netafname en teruglevering van de woning, en uit het verschil met wat je verwacht leid je af wat de batterij doet. De tweede route is de lokale API van de batterij of de fabrikantenmeter zelf: een adres op je eigen netwerk dat je software kan bevragen zonder internet. De derde route is de cloud-API: je software praat met de servers van de fabrikant, net als de app, en krijgt dezelfde gegevens terug.

Bij alle drie de routes gaat het om een vraag en een antwoord, meestal in een tekstformaat dat elke programmeertaal begrijpt. Je software stelt de vraag om de zoveel seconden en bewaart het antwoord. Wat de P1-poort van de slimme meter precies doorgeeft en in welk tempo, staat beschreven bij Netbeheer Nederland; die gegevens zijn de basis van de indirecte route.

Route 1: indirect via de P1-meter

Dit is de route die bijna iedereen kan gebruiken, ook zonder dat de batterij zelf een koppeling biedt. Een P1-meter van HomeWizard heeft bijvoorbeeld een lokale interface die je in de app aanzet, waarna Home Assistant hem vanzelf vindt. Andere P1-uitlezers werken vergelijkbaar of sturen hun gegevens naar een eigen dienst met een eigen koppeling. Je krijgt de netwaarde van de woning elke seconde of elke tien seconden binnen, plus de meterstanden.

Wat je hiermee niet ziet is de laadtoestand van de batterij en de precieze energie die erin en eruit gaat. Wel zie je het effect: een woning die rond nul schommelt terwijl het huis verbruikt, betekent dat de batterij ontlaadt. Voor een dashboard van de hele woning en voor eenvoudige regels, zoals een apparaat inschakelen als er teruglevering is, is dit ruim voldoende. De koppeling is bovendien officieel ondersteund en breekt zelden. Hoe je de verbinding stabiel houdt, lees je bij de wifi-verbinding van een stekkerbatterij.

Route 2: de lokale API van de batterij

Steeds meer merken bieden een lokale interface op de batterij of op hun eigen meter. HomeWizard heeft de lokale API van de P1-meter uitgebreid met de batterij, zodat je met een eenmalig toegangsbewijs, dat je bevestigt met een druk op de knop van de meter, de laadtoestand en het vermogen kunt opvragen en de modus kunt wijzigen tussen nulregeling en stand-by. Dat werkt volledig binnen je eigen netwerk en is door de fabrikant gedocumenteerd.

Bij andere merken is de lokale toegang niet officieel maar wel aanwezig: de batterij praat met de eigen meter of de app via een protocol dat gebruikers hebben uitgezocht en gedeeld. Dat levert vaak de rijkste gegevens, tot en met celspanningen en temperaturen, maar de fabrikant kan het protocol bij een update veranderen. Wie deze route kiest, houdt er rekening mee dat een koppeling na een update tijdelijk stil kan vallen totdat de gemeenschap hem heeft aangepast.

Route 3: de cloud-API

Sommige fabrikanten bieden een gedocumenteerde interface op hun servers, waarmee je dezelfde gegevens ophaalt die de app toont, vaak met een sleutel die je in je account aanmaakt. Het voordeel is dat je geen lokaal netwerk hoeft in te richten en dat de fabrikant de koppeling onderhoudt. Het nadeel is dat je afhankelijk blijft van hun servers, dat de gegevens met dezelfde vertraging binnenkomen als in de app, en dat het aantal vragen per minuut meestal beperkt is.

Voor loggen op dag- en uurniveau is de cloud-route prima. Voor een dashboard dat elke seconde ververst of voor regels die snel moeten reageren, is een lokale route beter. Een enkele fabrikant biedt geen van beide en laat gebruikers alleen de app; dan blijft de indirecte route via de P1-meter over.

Wat je ermee kunt als monitoringmiddel

Het eerste dat vrijwel iedereen doet, is een dashboard bouwen waarop batterij, zonnepanelen, net en eventueel laadpaal of warmtepomp naast elkaar staan. Home Assistant heeft daarvoor een energiepaneel dat uit de losse bronnen zelf een dagoverzicht maakt. Het tweede is bewaren: alle waarden per minuut in een eigen database, jarenlang, zodat je seizoenen kunt vergelijken en het rendement over de hele levensduur kunt volgen.

Het derde is opmerken. Je eigen software kan een bericht sturen als de P1-meter een minuut lang niets meldt, als de laadtoestand al dagen op honderd staat of als de temperatuur een grens nadert, ook wanneer de app van de fabrikant daar niets over zegt. Wat de standaardmeldingen wel en niet dekken, lees je bij meldingen en fouten van een stekkerbatterij. Een eigen bewaking vult die aan met precies de grenzen die jij belangrijk vindt.

Uitlezen versus aansturen

Uitlezen is onschuldig: je vraagt alleen om cijfers en verandert niets aan het gedrag van de batterij. Aansturen is een stap verder: je zet de batterij op stand-by als de auto laadt, of je dwingt laden af op een goedkoop uur. Dat kan bij merken met een gedocumenteerde interface en is bij andere merken via omwegen mogelijk, maar het vraagt om voorzichtigheid. Een regel die per ongeluk de batterij de hele nacht laat laden van het net, kost geld, en een regel die de nulregeling uitschakelt zonder hem terug te zetten, laat de batterij dagen stilstaan.

Begin daarom met uitlezen en bouw pas regels als je de gegevens een paar weken hebt bekeken. En laat de veiligheidsfuncties altijd bij de batterij zelf: temperatuurbewaking, celbalancering en de beveiliging bij stroomuitval regelt het beheersysteem, niet jouw script. Het uitgebreid automatiseren op basis van uurtarieven is een onderwerp voor slim energiebeheer en valt buiten dit artikel.

Wat je nodig hebt

Een klein apparaat dat altijd aanstaat, zoals een mini-computer of een oude laptop, met daarop Home Assistant, Homey of een vergelijkbaar platform. Een thuisnetwerk waarop batterij, P1-meter en dat apparaat elkaar kunnen zien, wat betekent dat ze in hetzelfde netwerk zitten en niet in een gastnetwerk. En wat tijd: een eerste dashboard via de indirecte route is in een avond klaar, een volledige koppeling met een niet-officieel protocol kan een weekend kosten.

Technische kennis hoeft niet diep te gaan. Wie een router kan instellen en een handleiding op een forum kan volgen, komt een heel eind. Wie nooit een configuratiebestand heeft aangeraakt, kiest beter een merk met een officiële integratie, zodat de koppeling zichzelf grotendeels instelt.

Risico's en beperkingen

Het grootste risico is afhankelijkheid van een niet-officieel protocol dat na een firmware-update verandert. Het tweede is netwerkbelasting: een script dat de batterij elke seconde bevraagt, kan een zwakke wifi in de meterkast overbelasten en de nulregeling zelf storen. Bevraag daarom niet vaker dan nodig; elke vijf tot tien seconden is voor monitoring ruim voldoende. Het derde is beveiliging: een lokale interface die zonder toegangsbewijs open staat, is bereikbaar voor alles op je netwerk, dus zet nooit poorten open naar buiten.

Tot slot garantie. Uitlezen heeft daar nooit invloed op. Aansturen via een omweg kan bij een geschil een discussiepunt worden, ook al is het zelden de oorzaak van een defect. Bewaar bij twijfel de logboeken van je eigen software, dan kun je laten zien wat er is gebeurd.

Merkverschillen in het kort

HomeWizard is het meest open: officieel onderdeel van het ecosysteem van Home Assistant, lokale interface op de P1-meter en sinds een firmware-update ook de batterij via die weg uitleesbaar en aanstuurbaar. Marstek biedt geen officiële integratie, maar de gemeenschap heeft koppelingen gebouwd die veel ruwe gegevens opleveren, met het bijbehorende risico bij updates. Jackery richt zich op de eigen app en laat de indirecte route via de P1-meter over als praktische optie. Een goed startpunt voor het meest open ecosysteem is het overzicht van de HomeWizard Plug-In Battery.

Een eenvoudige rekenoefening

Stel dat je met een eigen koppeling elke minuut de laadtoestand en het vermogen opslaat. Dat zijn ruim vijftienhonderd metingen per dag, ruim een half miljoen per jaar, en op een eenvoudige database is dat een paar honderd megabyte: verwaarloosbaar. Uit die reeks haal je aan het einde van het jaar exact hoeveel kilowattuur er per volle lading in de batterij ging in januari en in december, en dus of de capaciteit is gedaald en met hoeveel.

De app van de fabrikant kan dat na een jaar meestal niet meer, omdat de fijne data zijn samengevat. Voor wie een batterij van enkele duizenden euro's tien jaar wil volgen, is die ene reeks alleen al de moeite van een avond installeren waard.

Kort samengevat

Een API-koppeling brengt de gegevens van je stekkerbatterij naar je eigen software. De indirecte route via de P1-meter werkt bij vrijwel iedereen en is officieel ondersteund; de lokale route geeft de rijkste gegevens maar kan bij niet-officiële protocollen breken; de cloud-route is gemakkelijk maar afhankelijk van de fabrikant. Begin met uitlezen, bevraag niet te vaak, zet niets open naar buiten en laat de veiligheid bij de batterij. Voor wie graag bouwt en lang wil bewaren, is het de beste monitoring die er is.

Wat je hieraan hebt

✔️ Je bewaart de fijne gegevens van je batterij zo lang je wilt, ook nadat de app ze heeft samengevat.

✔️ Je ziet batterij, zonnepanelen, net en andere apparaten in een dashboard in plaats van in losse apps.

✔️ Je blijft inzicht houden als de servers van de fabrikant tijdelijk onbereikbaar zijn.

✔️ Je kunt eigen waarschuwingen instellen op grenzen die de standaardapp niet bewaakt.

Klaar om te kiezen? Bekijk dan de vergelijking van de beste stekkerbatterijen in ons onafhankelijke overzicht.

Zo pak je het slim aan

Nog niet zeker welk model bij jouw situatie past? Doe dan eerst onze keuzehulp, daarna maken deze gewoontes het verschil.

• Begin met de indirecte route via de P1-meter; die werkt bij vrijwel elk merk en is officieel ondersteund.
• Controleer voor aanschaf of je merk een gedocumenteerde lokale interface heeft als je de volledige gegevens wilt.
• Bevraag de batterij niet vaker dan elke vijf tot tien seconden, zodat de wifi in de meterkast rustig blijft.
• Zet nooit een lokale interface open naar het internet en gebruik altijd het toegangsbewijs van de fabrikant.
• Lees eerst een paar weken alleen uit voordat je regels bouwt die de batterij aansturen.
• Bewaar de logboeken van je eigen software; ze zijn nuttig bij storingen en bij een garantiegesprek.

Kosten

Een koppeling kost vooral tijd. De software is bij de gangbare platforms gratis of eenmalig enkele tientjes. Een mini-computer om het op te draaien kost rond de honderd euro; een oude laptop of een bestaande thuisserver volstaat ook. Een extra accesspoint voor een stabiele wifi in de meterkast kost dertig tot zestig euro en is vaak de beste investering van het hele project.

De batterij zelf blijft in de bekende bandbreedte van EUR 1.000 tot 4.500. De koppeling verandert daar niets aan, maar maakt wel zichtbaar of die investering over de jaren doet wat de fabrikant beloofde.

Zelf doen of uitbesteden

Dit is een doe-het-zelf-onderwerp bij uitstek; er zijn nauwelijks bedrijven die een thuisautomatiseringsplatform voor je inrichten rond een plug-in batterij, en wie het wel doet, rekent tarieven die de winst van het inzicht overstijgen. De indirecte route is bovendien zo laagdrempelig dat de meeste mensen hem in een avond zelf werkend hebben.

Wie geen zin heeft in configuratiebestanden, kiest bij aanschaf een merk met een officiële integratie. Dan is de koppeling een kwestie van een schakelaar in de app en een bevestiging op het platform, zonder handwerk.

Dynamisch energiecontract

Een stekkerbatterij verdient zich sneller terug met een dynamisch energiecontract: je laadt op de goedkoopste uren en ontlaadt als stroom duur is. Bekijk dynamische energie bij Frank Energie. Via deze link kunnen wij een commissie ontvangen; voor jou verandert de prijs niet.

Ervaringen

Wie eenmaal een eigen dashboard heeft, wil zelden meer terug naar alleen de app.

• Ik ben begonnen met alleen de P1-meter in Home Assistant. Binnen een avond zag ik batterij, panelen en laadpaal in een overzicht; meer had ik eigenlijk niet nodig.
• De niet-officiële koppeling van mijn batterij viel na een firmware-update twee weken stil. Sindsdien wacht ik met updaten tot de gemeenschap het heeft getest.
• Na anderhalf jaar loggen zie ik dat een volle lading nu vier procent minder kilowattuur kost dan in het begin. De app van de fabrikant had dat nooit kunnen laten zien.

💬 Twijfel je welke route bij jouw merk en netwerk past? Neem gerust contact met ons op.

Ook interessant

Deze artikelen sluiten aan op het uitlezen en koppelen van je batterij.

• Monitoring van een stekkerbatterij: het overzicht
• Verbruiksdata van je stekkerbatterij gebruiken
• Een plug-and-play batterij zonder internet
• Hoe het beheersysteem van een stekkerbatterij werkt

Meer vergelijken

Wil je ook andere producten onafhankelijk vergelijken? Op BesteReviews.nl vind je productvergelijkingen en koopgidsen in uiteenlopende categorieen.

Verder lezen

Meer achtergrond bij techniek, app en aanschaf.

• Stekkerbatterij-app instellen: de belangrijkste opties
• Technische vragen over stekkerbatterijen
• Stekkerbatterij kopen: het complete stappenplan
• Alle artikelen over stekkerbatterijen