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? Voer 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. Genereer er een onder Instellingen > Personal Access Tokens in het Plugchoice dashboard, dan kun je meteen de API aanroepen op je eigen account. Ideaal voor scripts, testen en interne tooling.
OAuth 2.0: voor producten die je klanten gebruiken. Je applicatie krijgt eigen toegang tot de gegevens van elke klant, met hun toestemming, zonder dat iemand wachtwoorden of tokens hoeft te delen.
Hoe OAuth eruitziet voor je klant
In jouw app klikt de klant op iets als Plugchoice koppelen.
Ze komen op het vertrouwde Plugchoice-inlogscherm en loggen in met hun eigen account.
Plugchoice vraagt ze om de toegang die jouw app vraagt goed te keuren, met één klik.
Ze gaan direct terug naar jouw app, die nu veilig eigen tokens voor die klant ontvangt.
Geen handmatig kopiëren van tokens, geen gedeelde wachtwoorden, en de klant kan de toegang op elk moment weer intrekken. Dit is dezelfde flow die klanten al kennen van het koppelen van andere diensten.
Toegang krijgen
Om OAuth voor jouw applicatie aan te zetten hebben we maar één ding van je nodig: je redirect URL (het adres in je app waar de klant naartoe terugkeert na goedkeuring). Stuur die naar ons via de messenger of je partnercontact, dan zetten wij je OAuth-client op en sturen we je de inloggegevens.
Voor personal access tokens is helemaal geen instelling van onze kant nodig: maak er een aan in het dashboard en begin met bouwen.