Schnellstart

Diese Anleitung führt dich vollständig durch den Ablauf — von den Zugangsdaten bis zum Planen eines Ladelimit-Profils und dessen Wirkung.

Voraussetzungen

Du benötigst zwei Dinge, beide aus dem RiDERgy-Dashboard:

OAuth-Client-Zugangsdaten (client_id und client_secret). Für deinen Mandanten muss die Energy Management API aktiviert sein. Kontaktiere RiDERgy, um sie zu aktivieren und deine Zugangsdaten zu erstellen — siehe Authentifizierung.
Die IDs der Ressourcen, die du steuern möchtest — eine locationId, die controllerUuid/connectorId eines Ladepunkts oder eine clusterId. Diese stammen aus deinem RiDERgy-Konto: Wenn du ein RiDERgy-Konto mit einem integrierten Standort hast, kannst du die IDs in der RiDERgy-App nachschlagen. Sie bezeichnen dieselben Standorte und Ladepunkte, die du dort siehst.

Die interaktiven „Try it”-Felder senden Anfragen an die produktive Live-API. Ein POST/PUT verändert hier einen echten Standort. Verwende nur Werte, die du wirklich anwenden möchtest.

1. Verbindung prüfen

GET /health benötigt keine Authentifizierung und bestätigt, dass die API erreichbar ist:

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

{ "status": "ok" }

2. Zugriffstoken anfordern

Tausche deine Client-Zugangsdaten gegen ein Bearer-Token (gültig für 1 Stunde):

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"
  }'

Speichere das access_token aus der Antwort — du benötigst es in den folgenden Schritten.

3. Permanentes Limit eines Standorts setzen

Das permanente Limit ist der Fallback, der gilt, wenn kein geplantes Profil aktiv ist.

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. Prioritätsprofil planen

Begrenze den Standort während eines bestimmten Zeitfensters auf 50 kW, mit Priorität 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
  }'

Das Profil wird automatisch zu seiner startTime/endTime angewendet und zurückgesetzt — weitere API-Aufrufe sind nicht nötig.

5. Effektives Limit überprüfen

Dies gibt jedes Profil mit einem berechneten status (SCHEDULED, ACTIVE, EXPIRED) sowie das aktuelle effectiveLimitKw zurück:

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

Im Prioritätsmodell ist genau beschrieben, wie das effektive Limit ermittelt wird.

Nächste Schritte

Authentifizierung — OAuth 2.0-Flow, Scopes und Token-Verwaltung.
Prioritätsmodell — wie Profile, Prioritäten und Cluster zusammenwirken.
Nutze die API-Referenz, um jeden Endpunkt mit einer Live-Umgebung zu erkunden.

Erste Schritte

Konzepte

Voraussetzungen

1. Verbindung prüfen

2. Zugriffstoken anfordern

3. Permanentes Limit eines Standorts setzen

4. Prioritätsprofil planen

5. Effektives Limit überprüfen

Nächste Schritte

​Voraussetzungen

​1. Verbindung prüfen

​2. Zugriffstoken anfordern

​3. Permanentes Limit eines Standorts setzen

​4. Prioritätsprofil planen

​5. Effektives Limit überprüfen

​Nächste Schritte

Voraussetzungen

1. Verbindung prüfen

2. Zugriffstoken anfordern

3. Permanentes Limit eines Standorts setzen

4. Prioritätsprofil planen

5. Effektives Limit überprüfen

Nächste Schritte