Met de Plugchoice REST API bouw je je eigen product bovenop het platform: laders, sessies en meterwaarden uitlezen, laden starten en stoppen, kaarten, locaties en energiebeheer beheren, en meer. Deze pagina is de korte versie voor partners; de volledige technische documentatie staat op developer.plugchoice.com.
Waar de documentatie staat
developer.plugchoice.com: de volledige API-referentie plus handleidingen over authenticatie, fouten, paginering en rate limiting.
Bouw je met een AI-assistent? Geef die developer.plugchoice.com/llms.txt (de index) of llms-full.txt (de hele documentatie in één bestand). Je AI-codetool kan dan vragen over de API beantwoorden en de integratie voor je schrijven.
Twee manieren om te authenticeren
Personal access token: de snelste start, voor je eigen gebruik van je eigen account, zoals scripts, testen, domotica of je eigen dashboard. Maak er een aan in het webportaal onder Instellingen > Je account > API-tokens met API-token aanmaken. Een token gebruiken in een product of dienst voor anderen, of om gegevens van andere accounts op te halen, vraagt om API Professional.
OAuth 2.0 (API Professional): voor producten die je klanten gebruiken. Je applicatie krijgt eigen toegang tot de gegevens van elke klant, met hun toestemming en binnen de scopes die ze goedkeuren, zonder dat iemand wachtwoorden of tokens deelt. API Professional loopt via een aparte overeenkomst over scopes, rate limits en tarieven.
Hoe OAuth eruitziet voor je klant
In jouw app klikt de klant op iets als Plugchoice koppelen.
Hij komt op het Plugchoice-inlogscherm en logt in met zijn eigen account, ook met Google of Apple.
Plugchoice laat zien welke toegang jouw app vraagt, en de klant keurt die goed met Toestaan.
Hij gaat terug naar jouw app, die nu eigen tokens voor die klant krijgt.
Niemand kopieert tokens of deelt wachtwoorden. De klant kan de toegang op elk moment intrekken in het webportaal onder Instellingen > Je account > Gekoppelde apps (Toegang intrekken), en voor één lader onder Instellingen > Apps van die lader.
Je klanten en hun gegevens
Je app gebruikt de gegevens van een klant alleen binnen de scopes die hij goedkeurde en voor je eigen dienst aan die klant.
Eigendomsoverdrachten, toegang verlenen en andere toestemmingsstappen automatiseer je nooit: de gebruiker bevestigt elke stap zelf.
Wie via jouw app, Link of de API een Plugchoice-account krijgt, is klant van Plugchoice onder onze voorwaarden, tenzij een getekende overeenkomst jou die klantrelatie geeft. We mogen deze klanten zelf informeren en hun de Plugchoice-app laten zien.
Trekt een klant de toegang in of wist hij zijn account, dan stuurt je app geen opdrachten meer naar zijn laders, wist je app de persoonsgegevens die ze via de API kreeg zonder onnodige vertraging, en wist ze andere API-gegevens binnen 30 dagen.
Toegang krijgen
OAuth valt onder API Professional. Stuur ons je redirect-URL (het adres in je app waar de klant na het goedkeuren naar terugkeert) via de messenger of je partnercontact. Zodra de overeenkomst rond is, zetten we je OAuth-client op en sturen we je de gegevens.
Personal access tokens hoeven wij niet in te stellen: maak er een aan in het webportaal en begin met bouwen.