Eén JSON-eindpunt, elk platform
Home Assistant krijgt de meeste aandacht — begrijpelijk, het is het meest gebruikte domoticaplatform, en we hebben er een hele gids aan gewijd. Maar het onderliggende mechanisme is bewust simpel: één HTTP-eindpunt, GET /api.json, geen authenticatie, gewoon JSON terug. Alles wat een HTTP-verzoek kan doen en JSON kan parsen, kan daaruit Pylontech-accudata halen. Dat geldt voor Jeedom, Node-RED, Domoticz, openHAB, Grafana, een Python-script, een cronjob met curl — allemaal lezen ze precies dezelfde data, geen van allen heeft een fabrikants-SDK of API-sleutel nodig.
Jeedom
Jeedom heeft geen speciale Pylontech-plugin nodig. Installeer de standaard JSON-plugin uit de Jeedom-store, richt een apparaat op http://<apparaat-ip>/api.json, en koppel JSON-paden aan commando's — summary>soc, summary>voltage, summary>state, net>rssi, enzovoort. Een polling-interval van 30–60 seconden is meer dan genoeg; accutelemetrie verandert niet snel genoeg om iets strakkers nodig te hebben.
Node-RED
Twee opties, die de keuze bij Home Assistant bijna exact weerspiegelen. Bevragen met een http request-node (methode GET, URL http://<apparaat-ip>/api.json, retourtype "a parsed JSON object"), getriggerd door een inject-node op een timer, en velden zoals msg.payload.summary.soc verderop in de flow uitlezen. Of, als MQTT al is geconfigureerd op het apparaat, in plaats daarvan rechtstreeks abonneren op pylon-monitor/state met een MQTT-in-node — updates komen binnen zodra ze gebeuren, geen pollinglus te beheren.
Domoticz
Domoticz heeft standaard geen native JSON-pollingsensor, maar de gangbare oplossing is goed beproefd: een klein script (Python, of Domoticz' eigen Lua-/Blockly-eventscripting) haalt /api.json op met een timer en stuurt de waarden via Domoticz' eigen JSON-API naar Dummy/Virtual-sensoren. Dat kost een paar minuten meer instellen dan Jeedom of Node-RED, maar het is eenmalig werk, en de sensoren gedragen zich daarna precies als elk ander Domoticz-apparaat — volledige geschiedenisgrafieken, meldingen, alles.
openHAB
De HTTP Binding van openHAB regelt dit native: definieer een Thing die naar http://<apparaat-ip>/api.json wijst met een verversingsinterval, koppel dan individuele channels aan JSON-paden via een transformatie (JSONPath) om summary.soc, summary.voltage, enz. naar aparte Items te halen. Geen aangepaste binding nodig — de generieke HTTP-binding dekt het.
Grafana, scripts, en al het andere
Heeft een tool een "JSON API"- of "HTTP"-databron — Grafana's JSON API-plugin, Telegraf's HTTP-input, een Python-script met requests, een shell-regel met curl | jq — dan kan het dit eindpunt op dezelfde manier uitlezen. Dit is bewust geen ommuurde tuin: het apparaat maakt niet uit wat er aan de andere kant van het HTTP-verzoek zit, wat betekent dat het niet overbodig wordt op de dag dat u van domoticaplatform wisselt.
Polling versus MQTT: wat waar te gebruiken
De meeste platforms hierboven bevragen standaard de JSON-API op een timer, wat simpel is en overal werkt. Spreekt uw platform ook MQTT (Node-RED en Home Assistant doen dat allebei native), dan betekent abonneren op pylon-monitor/state in plaats daarvan dat updates binnenkomen zodra ze gepubliceerd worden in plaats van te wachten op de volgende polling — en u krijgt ook het retained beschikbaarheids-topic er gratis bij, om meteen te weten of het apparaat zelf offline is gegaan in plaats van dit te gokken aan een verouderde waarde. Elke 30–60 seconden pollen is echter meer dan voldoende voor alles wat met de accu te maken heeft — dit zijn geen data die baat hebben bij subseconde-latentie.
De JSON-API en MQTT-topics van Pylon-Monitor zijn vanaf dag één open, gedocumenteerd en platformonafhankelijk — sluit ze aan op wat u al gebruikt.
Nu bestellen — 39 € Eenmalige aankoop, € 39 incl. btw — geen abonnement.