> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ridergy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Snelstartgids

> Doe je eerste Energy Management API-verzoek in enkele minuten

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**:

1. **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](/nl/authentication).
2. **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.

<Note>
  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.
</Note>

## 1. Controleer de connectiviteit

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

```bash theme={null}
curl https://api.ridergy.com/v1/health
```

```json theme={null}
{ "status": "ok" }
```

## 2. Verkrijg een toegangstoken

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

```bash theme={null}
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.

```bash theme={null}
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:

```bash theme={null}
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`:

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

Zie het [Prioriteitsmodel](/nl/concepts/priority-model) voor precies hoe het effectieve limiet wordt bepaald.

## Volgende stappen

* [Authenticatie](/nl/authentication): OAuth 2.0-flow, scopes en tokenbeheer.
* [Prioriteitsmodel](/nl/concepts/priority-model): hoe profielen, prioriteiten en clusters samenwerken.
* Gebruik de **API Reference** om elk endpoint te verkennen met een live playground.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.