cluuub Platform·Developer Documentation
Verbinde deine Vereinsanwendung.
Vereinsgebundene API-Keys, definierte Lese- und Buchungszugriffe sowie nachvollziehbare JSON-Fehlerantworten.
Verfügbare Endpunkte
- GET /api/v1/groups · read:groups
- Aktive Gruppen: Name, Sport, Altersbereich, Leistungsstufe und Beschreibung.
- GET /api/v1/events · read:events
- Termine, die ausdrücklich für öffentliche Buchung freigegeben und keiner Gruppe zugeordnet sind.
- GET /api/v1/news · read:news
- Veröffentlichte Gruppennachrichten dieses Vereins: Titel, Inhalt, Veröffentlichungsdatum und Ersteller.
- GET /api/v1/competition-results · read:competition_results
- Wettkampfergebnisse des Vereins: Mitglied, Gruppe, Wettkampf, Disziplin, Platzierung, Punkte und Datum.
- GET /api/v1/public/[clubSlug]/courts · Öffentlich
- Liste aller aktiven Sportstätten & Tennisplätze inkl. Belegungsstatus für ein gewähltes Datum (CORS-aktiviert).
- POST /api/v1/public/[clubSlug]/courts/book · Öffentlich
- Gast- und Mitglieder-Platzbuchung mit automatischer Überlappungsprüfung und Bestätigungs-E-Mail (CORS-aktiviert).
Rate Limiting & Quotas: Je Key bis zu 60 Requests sofort (Token Bucket, 1 Req/s Nachfüllrate); höchstens 10.000 autorisierte Requests pro UTC-Tag. Pagination: limit 1–100, offset 0–10000.