> ## 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.

# Schnellstart

> Stelle deine erste Anfrage an die Energy Management API in wenigen Minuten

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

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

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

## 1. Verbindung prüfen

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

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

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

## 2. Zugriffstoken anfordern

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

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

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.

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

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

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:

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

Im [Prioritätsmodell](/de/concepts/priority-model) ist genau beschrieben, wie das effektive Limit ermittelt wird.

## Nächste Schritte

* [Authentifizierung](/de/authentication) — OAuth 2.0-Flow, Scopes und Token-Verwaltung.
* [Prioritätsmodell](/de/concepts/priority-model) — wie Profile, Prioritäten und Cluster zusammenwirken.
* Nutze die **API-Referenz**, um jeden Endpunkt mit einer Live-Umgebung zu erkunden.


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