# REST-API-Referenz

Die derzeit veröffentlichten Leseendpunkte, Parameter und Antwortstrukturen.

Source: https://docs.getridian.com/de/developers/rest/
Language: de
Reviewed: 2026-09-20

## Basis-URL und Autorisierung

Verwende `https://api.getridian.com/v1` mit einem delegierten Bearer-Token und `calendar:read`. Es gelten dieselben Freigabe- und Inhaltsprüfungen wie bei MCP. Das öffentliche [OpenAPI-Dokument](https://api.getridian.com/v1/openapi.json) beschreibt derzeit einen minimalen Leseschnitt, keinen vollständigen Partner-SDK-Vertrag.

## GET /calendars

Listet zugängliche Kalender. Die Antwort enthält `data` mit der Kalenderliste und `meta.excluded` mit Ausschlussinformationen. Nutze die gelieferten opaken IDs; leite sie nicht aus Anbieter-Mailadressen ab.

```sh
curl https://api.getridian.com/v1/calendars \
  -H "Authorization: Bearer $RIDIAN_ACCESS_TOKEN"
```

## GET /events

| Query-Parameter | Erforderlich | Bedeutung |
| --- | --- | --- |
| `calendar_id` | Ja | Erlaubte Kalender-IDs; Parameter wiederholen oder IDs mit Komma trennen |
| `start` | Ja | ISO-Zeitstempel mit `Z` oder ausdrücklichem Offset |
| `end` | Ja | Ende des Fensters, ebenfalls mit `Z` oder Offset |
| `time_zone` | Für CalDAV ohne bekannte Zone | IANA-Zone des Nutzers, beispielsweise `Europe/Berlin` |

Das Fenster ist auf 20 Kalender und 31 Tage begrenzt. Die Antwort enthält erlaubte Termine in `data`. `canEdit` und `canRespond` berücksichtigen auch effektive Token-Scopes, nicht nur Anbieterrechte.

```sh
curl --get https://api.getridian.com/v1/events \
  -H "Authorization: Bearer $RIDIAN_ACCESS_TOKEN" \
  --data-urlencode "calendar_id=$RIDIAN_CALENDAR_ID" \
  --data-urlencode 'start=2026-10-25T00:00:00+02:00' \
  --data-urlencode 'end=2026-10-26T00:00:00+01:00' \
  --data-urlencode 'time_zone=Europe/Berlin'
```

Setze Token- und Kalendervariablen privat; ihre Werte gehören nicht ins Repository. Die Beispielzeiten zeigen bewusst einen 25-Stunden-Tag beim Sommerzeitwechsel. Wähle für deinen Test ein passendes Fenster.

## Fehler und nicht unterstützte Aktionen

Ungültige Parameter liefern einen Fehler statt einer geratenen Zeitzone. Eine fehlende CalDAV-Zone ergibt `time_zone_required`. Autorisierungs- und Serverfehler benötigen den jeweiligen Lösungsweg. Siehe [Fehler](https://docs.getridian.com/de/developers/errors/).

REST-Anlage, -Änderung, -Löschung und ein eigener Verfügbarkeitsendpunkt sind geplante Developer-Arbeit, nicht dieser veröffentlichte Lesevertrag. Nutze passende MCP-Werkzeuge; erfinde keine REST-Pfade aus Werkzeugnamen.