Snelstartgids

Deze gids leidt je van begin tot eind: van het verkrijgen van je inloggegevens tot het plannen van een laadlimietprofiel en het live zien werken ervan.

Vereisten

Je hebt twee dingen nodig, beide uit het RiDERgy dashboard:

OAuth-clientgegevens (client_id en client_secret). Je tenant moet de Energy Management API geactiveerd hebben. Neem contact op met RiDERgy om deze te activeren en je inloggegevens aan te maken, zie Authenticatie.
De ID’s van de resources die je wilt aansturen: een locationId, de controllerUuid/connectorId van een laadpunt, of een clusterId. Deze komen uit je RiDERgy-account: als je een RiDERgy-account hebt met een geïntegreerde locatie, kun je de ID’s opzoeken in de RiDERgy-app. Ze identificeren dezelfde locaties en laadpunten die je daar ziet.

De interactieve Try it-panelen sturen verzoeken naar de live productie-API. Een POST/PUT hier wijzigt een echte site. Gebruik alleen waarden die je daadwerkelijk wilt toepassen.

1. Controleer de connectiviteit

GET /health vereist geen authenticatie en bevestigt dat de API bereikbaar is:

curl https://api.ridergy.com/v1/health

{ "status": "ok" }

2. Verkrijg een toegangstoken

Wissel je clientgegevens in voor een Bearer-token (geldig voor 1 uur):

curl -X POST https://api.ridergy.com/v1/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET"
  }'

Bewaar het access_token uit de respons, je gebruikt het in de volgende stappen.

3. Stel het permanente limiet van een locatie in

Het permanente limiet is de terugvallimiet die geldt wanneer er geen gepland profiel actief is.

curl -X PUT https://api.ridergy.com/v1/locations/{locationId}/limit \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "limitKw": 100 }'

4. Plan een prioriteitsprofiel

Beperk de locatie tot 50 kW tijdens een specifiek tijdvenster, op prioriteit 5:

curl -X POST https://api.ridergy.com/v1/locations/{locationId}/schedules \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "startTime": "2026-01-01T08:00:00Z",
    "endTime":   "2026-01-01T18:00:00Z",
    "limitKw":   50,
    "priority":  5
  }'

Het profiel wordt automatisch toegepast en teruggedraaid op de startTime/endTime, er zijn geen verdere API-aanroepen nodig.

5. Controleer het effectieve limiet

Dit geeft elk profiel terug met een berekende status (SCHEDULED, ACTIVE, EXPIRED) en het huidige effectiveLimitKw:

curl https://api.ridergy.com/v1/locations/{locationId}/limits \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Zie het Prioriteitsmodel voor precies hoe het effectieve limiet wordt bepaald.

Volgende stappen

Authenticatie: OAuth 2.0-flow, scopes en tokenbeheer.
Prioriteitsmodel: hoe profielen, prioriteiten en clusters samenwerken.
Gebruik de API Reference om elk endpoint te verkennen met een live playground.

Aan de slag

Concepten

Vereisten

1. Controleer de connectiviteit

2. Verkrijg een toegangstoken

3. Stel het permanente limiet van een locatie in

4. Plan een prioriteitsprofiel

5. Controleer het effectieve limiet

Volgende stappen

​Vereisten

​1. Controleer de connectiviteit

​2. Verkrijg een toegangstoken

​3. Stel het permanente limiet van een locatie in

​4. Plan een prioriteitsprofiel

​5. Controleer het effectieve limiet

​Volgende stappen

Vereisten

1. Controleer de connectiviteit

2. Verkrijg een toegangstoken

3. Stel het permanente limiet van een locatie in

4. Plan een prioriteitsprofiel

5. Controleer het effectieve limiet

Volgende stappen