Zum Inhalt springen
CLUP.life
Inhalt der Dokumentation

Entwickler Beispiele

Beispiele in curl, JavaScript und Python

Kopierbare Beispiele für die CLUP.life-API: Termine abrufen, durch Seiten blättern, Termin anlegen, Fehler behandeln — in curl, JavaScript und Python.

Die Beispiele lesen den Schlüssel aus der Umgebungsvariable CLUP_API_KEY. Setze sie vor dem Start (export CLUP_API_KEY=clup_k_…). Die Sprache deiner Wahl bleibt auf allen Seiten erhalten.

Termine eines Zeitraums#

GET/ext/events

Termine eines Zeitraums

Bereiche: events:read

curl -H "Authorization: Bearer clup_k_…" \
  "https://api.clup.life/api/v1/ext/events?from=2026-11-01T00:00:00Z&to=2026-12-01T00:00:00Z"

Durch Seiten blättern#

Listen (Beiträge, Mitteilungen, Aufgaben, Mitglieder) liefern items und nextCursor. Ruf so lange mit dem Cursor erneut auf, bis er null ist.

# erste Seite
curl -H "Authorization: Bearer $CLUP_API_KEY" \
  "https://api.clup.life/api/v1/ext/organizations/mein-verein/posts?limit=50"
# nächste Seite: den Wert von nextCursor einsetzen
curl -H "Authorization: Bearer $CLUP_API_KEY" \
  "https://api.clup.life/api/v1/ext/organizations/mein-verein/posts?limit=50&cursor=<nextCursor>"

Einen Termin anlegen (Organisationsschlüssel)#

POST/ext/organizations/{org}/events

Termin anlegen

Bereiche: events:writePremium (Organisationsschlüssel)

curl -X POST -H "Authorization: Bearer clup_k_…" \
  -H "Content-Type: application/json" \
  -d '{"title":"Sommerfest","startsAt":"2026-07-04T14:00:00Z","endsAt":"2026-07-04T20:00:00Z","visibility":"MEMBERS"}' \
  "https://api.clup.life/api/v1/ext/organizations/mein-verein/events"

Fehler und Wiederholung behandeln#

Wiederhole nur bei 429 (nach Retry-After) und bei 5xx (mit wachsender Wartezeit). Alle anderen 4xx sind endgültig: ein erneuter Versuch ändert nichts.

# --retry wiederholt bei 429/5xx automatisch; --retry-all-errors nicht verwenden (würde auch 4xx wiederholen)
curl --retry 3 --retry-delay 5 --fail-with-body \
  -H "Authorization: Bearer $CLUP_API_KEY" \
  "https://api.clup.life/api/v1/ext/me"

Exporte#

iCal und CSV sind Exporte für Kalender und Tabellen. Die CSV-Dateien verwenden Semikolon, UTF-8 mit BOM und schützen vor Formeleinschleusung (Zellen, die mit =, +, - oder @ beginnen, werden entschärft).

GET/ext/exports/events.ics

Termine als iCal

Bereiche: exports:read

curl -H "Authorization: Bearer clup_k_…" \
  "https://api.clup.life/api/v1/ext/exports/events.ics?from=2026-11-01T00:00:00Z&to=2026-12-01T00:00:00Z"
Beispiele in curl, JavaScript und Python · CLUP.life