Je Zaptec Go laadpaal en je Homey Pro kunnen prima samenwerken, maar de standaard app in de Homey App Store ontbreekt vaak aan diepgaande integratie voor energiebeheer. De oplossing?
▶Inhoudsopgave
Een koppeling via de API. Dit stelt je in staat om laadsessies te sturen op basis van je zonnepanelen output of je slimme thermostaat schema, wat zorgt voor een slimmer energieverbruik zonder extra kosten. We gaan dit stap voor stap opzetten, zodat je de volledige controle krijgt.
Wat je nodig hebt voor de koppeling
Voordat we beginnen, check even of je de juiste spullen bij de hand hebt. Je hebt een werkende Homey Pro (bij voorkeur de 2023 versie voor de beste performance) en een Zaptec Go laadpaal die al is geïnstalleerd en functioneert via de Zaptec app.
Zorg dat je internet stabiel is; een draadloze verbinding kan soms haperen bij het aanroepen van APIs. Verder heb je toegang nodig tot je Homey Pro via de webinterface of de Homey Pro Desktop App (beschikbaar voor macOS en Windows). Je moet inloggen als 'gebruiker' en niet als 'bezoeker'.
Ook belangrijk: je hebt een Zaptec account nodig met beheerdersrechten. Als je deze gegevens niet hebt, moet je eerst een wachtwoord reset doen via de Zaptec app, wat ongeveer 5 minuten duurt.
Wat je verder nog moet verzamelen: een notitieblok of een digitale teksteditor om API-sleutels en IDs op te schrijven. Verwissel ze niet, want een verkeerd ID zorgt voor een foutmelding die lastig te debuggen is. Tenslotte: schakel even je VPN uit als je er een gebruikt, want sommige APIs blokkeren anonieme verkeer.
Stap 1: Haal je Zaptec API-sleutel op
De Zaptec Go gebruikt een API-token om te communiceren. Zonder deze sleutel krijg je geen verbinding. Open eerst de Zaptec app op je telefoon of log in via de browser op de Zaptec portal.
Ga naar de instellingen van je laadpaal; dit vind je meestal onder het tandwielicoon rechtsboven.
Zoek naar 'API-toegang' of 'Gebruikersbeheer'. Klik op 'Nieuwe sleutel genereren'.
Je krijgt nu een lange string van letters en cijfers. Kopieer deze direct naar je notitieblok. De naam van de sleutel mag je zelf kiezen, bijvoorbeeld "Homey_Pro_Koppeling".
Tip: Maak een aparte map in je wachtwoordenmanager aan voor API-sleutels. Zo voorkom je dat je ze kwijtraakt.
Belangrijk: bewaar deze sleutel veilig. Iedereen met deze sleutel kan je laadpaal aansturen.
De geldigheid is oneindig tenzij je handmatig intrekt. Controleer of je rechten hebt om laadsessies te starten en stoppen; sommige basisgebruikers hebben dit niet standaard. Test even of de sleutel werkt door een simpele aanroep te doen via een tool zoals Postman, maar dat is niet verplicht voor deze handleiding. Als je de sleutel hebt, zijn we klaar voor de volgende stap. Dit duurt ongeveer 3 minuten.
Stap 2: Vind je Homey API-token
Homey Pro heeft een eigen API-token die we nodig hebben om flows te activeren. Open de Homey Pro Desktop App of ga naar de webinterface (typ in je browser: homey.local en log in).
Zorg dat je ingelogd bent met het account waarop je de flows maakt.
Klik op je profielicoon rechtsboven en ga naar 'Instellingen'. Zoek naar 'API-token' of 'Ontwikkelaar'. Als je deze niet ziet, moet je eerst de 'Ontwikkelaarsmodus' inschakelen.
Dit doe je door 5 keer op het Homey-logo te tikken in de app; een pop-up verschijnt en je activeert de modus. Kopieer nu het API-token.
Het ziet eruit als een reeks van ongeveer 64 tekens. Plak dit in je notitieblok naast je Zaptec sleutel. Zonder dit token kan Homey geen commando's ontvangen van externe systemen. Dit proces duurt maximaal 2 minuten.
Let op: dit token geeft volledige toegang tot je Homey. Deel het niet.
Als je het per ongeluk deelt, reset het dan direct via de instellingen. Je kunt maximaal 5 tokens aanmaken, dus kies verstandig.