Wat biedt de Stekker API?
De Stekker API is een REST API waarmee je als ontwikkelaar of technisch integrator kunt communiceren met het Stekker-platform. De API biedt toegang tot smart charging functionaliteit, batterij-aansturing (BESS) en marktdata.
Alle API-communicatie verloopt via HTTPS en JSON. De API is organisatie-scoped: elke credential geeft toegang tot de data van een specifieke organisatie.
Authenticatie
Alle API-requests vereisen een Bearer token in de Authorization-header:
Authorization: Bearer jouw-api-tokenAPI-credentials worden per organisatie aangemaakt en zijn gekoppeld aan specifieke scopes. Een scope bepaalt tot welke onderdelen van de API je toegang hebt. De beschikbare scopes zijn:
- events — ontvangen en versturen van laadgebeurtenissen (OCPP/sensor events)
- bess — beheer van batterij-opslagsystemen, netaansluitingen en sensoren
- price_forecast — opvragen van day-ahead marktprijzen en prijsvoorspellingen
- charge_energy_forecast — opvragen van energieverbruikvoorspellingen voor laadsessies
Stekker biedt een aparte staging-omgeving om je integratie te testen voordat je live gaat.
Beschikbare endpoints
De API is opgedeeld in twee hoofdonderdelen:
Smart Charging API
De basis-API op api.stekker.app/api/v1/ voor laadinfrastructuur-integratie:
- Events — ontvang en verwerk OCPP-events en sensorgebeurtenissen van laadpunten. Dit is het hart van de smart charging integratie: meterwaarden, statusnotificaties en sessie-informatie komen hier binnen.
- Market Price Forecast — haal day-ahead energieprijzen op per marktregio (standaard NL). Bevat actuele prijzen, voorspellingen en het aankomende prijsminimum. Beschikbaar per kwartier- of uurinterval.
- Charge Energy Forecast — vraag een voorspelling op van het verwachte energieverbruik van een laadsessie op basis van historische meetwaarden.
BESS API
De Battery Energy Storage System API op api.stekker.app/api/bess/v1/ voor batterij-opslagintegratie:
- Grid Connections — registreer en beheer netaansluitingen met locatie, zekeringslimiet en marktregio-configuratie.
- Batteries — registreer batterijen met hun technische specificaties (capaciteit, laad-/ontlaadvermogen, SoC-limieten, rendement). Vraag geoptimaliseerde laadplanningen aan: cash-optimized (op basis van marktprijzen) of solar-optimized (op basis van productie- en verbruiksvoorspellingen).
- Sensors — registreer sensoren aan een netaansluiting en stuur meetwaarden in (vermogen, energie-import). Haal historische meetdata en voorspellingen op per sensor.
De BESS API beschikt over ingebouwde Swagger-documentatie op /api/bess/v1/swagger_doc.
Documentatie
Uitgebreide technische documentatie, inclusief voorbeeldberichten en protocolbeschrijvingen, is beschikbaar op developer.stekker.com. Daar vind je onder andere:
- Authenticatie-instructies en voorbeeldverzoeken
- Beschrijving van het pairingproces voor laadpunten
- OCPP event-formaten en statusnotificaties
- Meterwaarden en sensor measurements
- Charging profiles en smart charging UI-integratie
- Day-ahead prijsdata en sessie-pricing
Aan de slag
Wil je de Stekker API gaan gebruiken? Zo werkt het:
- Neem contact op met [email protected] of je accountmanager en beschrijf je use case.
- Ons team maakt API-credentials aan voor je organisatie, met de juiste scopes voor jouw integratie.
- Je ontvangt tokens voor zowel de staging- als productieomgeving.
- Test je integratie op de staging-omgeving voordat je live gaat.
Voor technische vragen tijdens de integratie kun je terecht bij [email protected].
