Seiten
Das Mitgliederverzeichnis und die Liste geleisteter Dienste liefern Seiten:pagebeginnt bei 1 (höchstens 1000),itemsPerPage1–100 (Standard 25).hasMoresagt, ob es eine weitere Seite gibt – frage so langepage + 1ab, bishasMorefalseist.
{ "items": [...] }: Communities, eigene Rollen, Beitrittsanfragen, Kurse, Freischaltungen, Fortschritt. Termine fragst du für einen Zeitraum ab (siehe unten).
Filter
Unbekannte Parameter werden ignoriert, ungültige Werte ergeben
422 mit dem Parameter in violations.
Zeiten, Zeitzonen, Geld, IDs
- Zeitpunkte in Antworten sind ISO 8601 mit Zeitzone, in UTC:
2026-11-05T18:00:00.000+00:00. - Events legst du wie im Kalender mit Wandzeit an:
startsAt/endsAtalsYYYY-MM-DDTHH:MMplustimezone(z. B.Europe/Berlin). Serien (recurrenceweekly,monthly= gleicher Tag im Monat odermonthly_weekday= Wochentag des Beginns in bestimmten Wochen) behalten die Uhrzeit über die Zeitumstellung. Beimonthly_weekdaygibst du inrecurrenceWeeksdie Wochen an –1bis4,-1für den letzten –, z. B.[1]für jeden 1. Sonntag oder[3, -1]für jeden 3. und letzten Montag; der Beginn muss selbst einer dieser Termine sein (sonst 422). - Geldbeträge sind ganze Zahlen in Cent plus
currency(z. B.priceCents: 4900,currency: "eur"). - IDs sind UUIDs.
userIdist die Konto-ID eines Mitglieds und in allen Communities gleich. - Links in die Oberfläche (
profileUrl,webUrl,avatarUrl) sind absolute Adressen deiner Installation. - Alle Felder einer Antwort sind immer vorhanden; fehlende Werte sind
null.
Fehler
Fehler kommen als Problem Details nach RFC 9457 (Content-Type: application/problem+json):
title und detail kommen auf Deutsch oder Englisch – nach der Sprache des Kontos bzw. Accept-Language. Werte für Programme sind status und type, nicht der Text.
Limits
Je API-Schlüssel gelten 300 lesende Aufrufe (GET) und 60 schreibende Aufrufe (POST, PUT, DELETE) pro Minute. Jede Antwort trägt X-RateLimit-Limit und X-RateLimit-Remaining; beim Überschreiten kommt 429 mit Retry-After (Sekunden). Warte dann mindestens so lange, bevor du es erneut versuchst. Für große Abgleiche lohnt itemsPerPage=100.
Doppelte Aufrufe vermeiden
Schickst du bei einemPOST die Kopfzeile Idempotency-Key mit (z. B. eine UUID je Vorgang), liefert QuickTribe bei einer Wiederholung mit demselben Wert die erste Antwort erneut, statt die Aktion ein zweites Mal auszuführen (erkennbar an Idempotent-Replayed: true). Das hilft bei Netzwerkabbrüchen, etwa beim Anlegen von Events.
Versionierung
Die Version steht im Pfad (/api/rest/v1/). Innerhalb von v1 kommen höchstens neue Endpunkte und neue Felder in Antworten hinzu – ignoriere unbekannte Felder. Umbenennen oder Entfernen gibt es nur mit einer neuen Version (/v2/), die eine Zeit lang parallel läuft. Änderungen stehen in den Änderungen.