REST-API-Referenz

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

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 744 verstrichene Stunden (31 × 24 Stunden) begrenzt. Durch die Umstellung auf Winterzeit können 31 lokale Kalendertage 745 Stunden umfassen. Teile längere Zeiträume in direkt aufeinanderfolgende Fenster; das Ende jedes Fensters ist exklusiv. Die Antwort enthält erlaubte Termine in data. canEdit und canRespond berücksichtigen auch effektive Token-Scopes, nicht nur Anbieterrechte. Bei canEdit=false nennt editBlockedReason den bestätigten Grund, etwa recurring_event, calendar_read_only oder access_denied; unknown bezeichnet einen unbekannten Grund. version_unavailable bedeutet, dass die für sicheres Schreiben benötigte Version nicht bestätigt werden konnte. Kalender können über das optionale providerPreset dem erkannten CalDAV-Dienst zugeordnet werden (apple für iCloud). Diese Angaben erweitern keine Berechtigung.

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.

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.