Voor developers & domotica-integratoren

NRGkick API: koppel uw laadkabel aan uw smart home

Met de lokale API van de NRGkick integreert u uw laadkabel rechtstreeks in uw smart home-systeem en programmeert u eigen automatiseringen. In tegenstelling tot de app haalt u via de API nog preciezere gegevens op en stuurt u het laadproces volledig automatisch aan.

Vraag uw offerte aan
Ontdek de NRGkick

Wat is een lokale API?

Een API (Application Programming Interface) is een verzameling commando’s waarmee twee toestellen rechtstreeks informatie uitwisselen. Elke aanvraag heeft een vooraf gedefinieerd antwoord — er kan geen data verzonden worden buiten deze vastgelegde commando’s om, wat de integratie zowel krachtig als veilig maakt. De NRGkick’s lokale API is beschikbaar in twee protocollen, elk met hun eigen voordelen.

JSON API

Een lokale REST-API die informatie via overzichtelijke endpoints teruggeeft, zoals GET /info voor toestelgegevens (serienummer, MAC-adres) en GET /values voor real-time meetgegevens (vermogen, energie, temperaturen). Ideaal wanneer u snel en makkelijk leesbare data wilt uitlezen.

Modbus API

Werkt met individuele geheugenadressen in plaats van gebundelde endpoints. Alle registers gebruiken het little-endian formaat en zijn opvraagbaar via Unit ID 1. Het voordeel: u vraagt exact de waarden op die u nodig heeft, zonder overbodige data mee te versturen.

Meer mogelijkheden dan de app

Waar u in de NRGkick-app zelf actief uw laadstroom moet aanpassen, laat de API u dit volledig automatiseren. Zo bouwt u zelf logica op basis van real-time gegevens — bijvoorbeeld om automatisch bij te sturen op basis van uw zonnepaneelopbrengst of uw totale elektriciteitsverbruik thuis.

  • Preciezere en meer gedetailleerde data dan via de app
  • Volledig automatiseerbaar, geen manuele tussenkomst nodig
  • Twee protocollen: JSON API en Modbus TCP API
  • Optionele BasicAuth-authenticatie voor extra beveiliging
  • Uitgebreide, officiële documentatie beschikbaar

Alles wat u moet weten over de NRGkick API

Van activatie tot concrete toepassingen: hier vindt u alle technische details over de lokale API.

De lokale API moet u eerst activeren via de NRGkick-app. Open de app, verbind met uw toestel, ga naar Instellingen → JSON API, en schakel de API in. Optioneel kan u hier meteen BasicAuth-authenticatie instellen, zodat enkel geautoriseerde toestellen toegang krijgen tot uw NRGkick. Voor de Modbus API geldt een gelijkaardige activatie via de app-instellingen.

Het endpoint GET /info geeft identificatiegegevens terug zoals het serienummer en MAC-adres, waarmee u uw toestel uniek herkent binnen uw systeem. Het endpoint GET /values geeft real-time telemetrie: actueel vermogen, verbruikte energie en temperatuurmetingen. Beide endpoints kunnen ook per sectie worden opgevraagd, zodat u enkel de gegevens ontvangt die u nodig heeft — handig als u de belasting op uw eigen systeem wil beperken.

De Modbus API werkt via genummerde registeradressen in plaats van via endpoints. Alle registers gebruiken het little-endian formaat en zijn te bevragen via Unit ID 1. Belangrijk: adressen moeten steeds gelezen worden met hun juiste registerlengte; blijft u binnen de correcte uitlijning, dan kan u ook meerdere adressen tegelijk uitlezen. Dit protocol is vooral interessant voor integratie met industriële energiebeheersystemen die al standaard met Modbus werken.

Dankzij de open, gedocumenteerde JSON API bestaat er zelfs een open-source Python-bibliotheek waarmee ontwikkelaars hun NRGkick rechtstreeks koppelen aan Home Assistant, een populair open-source domoticaplatform. Dat toont meteen de kracht van de lokale API: u bent niet beperkt tot de officiële NRGkick-app, maar kan zelf (of via uw domotica-integrator) volledig op maat gemaakte automatiseringen bouwen.

De API is de ideale basis om PV-laden nog verder te automatiseren: in plaats van te vertrouwen op de vaste laadstrategieën in de app, leest u via de API real-time uw zonne-energieopbrengst uit en past u zelf de laadstroom aan. Beheert u meerdere laadpunten of grote verbruikers, dan vormt de API ook de technische basis voor ons systeem voor piekbelasting beheer, en sluit ze naadloos aan op OCPP-laadnetwerkintegraties voor vlootbeheerders.

Wilt u de NRGkick API gebruiken?

Neem contact met ons op voor de volledige technische documentatie, of vraag meteen uw offerte aan.