Für wen
Rechte: immer die aktuellen des Kontos
Ein API-Schlüssel hat keine eigenen Rechte. Bei jedem Aufruf prüft QuickTribe die Rechte des Kontos, zu dem der Schlüssel gehört – so, als würde die Person selbst in der Oberfläche klicken:- Wird ein Admin zum Moderator oder Mitglied, wirkt sein Schlüssel in dieser Community sofort nicht mehr (Antwort
403). Bekommt er die Rolle zurück, funktioniert der Schlüssel wieder. - Verliert ein Plattform-Admin dieses Recht, erreicht sein Schlüssel nur noch die Communities, in denen er selbst Owner oder Admin ist.
- Wird das Konto gelöscht, werden seine Schlüssel entfernt.
- Gesperrte Communities erreichen nur Plattform-Admins, gelöschte niemand (
404).
Communities anlegen und Admins benennen
Für Betreiber, die Communities automatisiert einrichten (etwa nach einer Bestellung im eigenen Shop):POST /api/rest/v1/communitiesmitname, optionaldescription,visibility(public/private)slugundtemplate– nur mit dem Schlüssel eines Plattform-Admins. Die Community entsteht wie über Community anlegen; das Konto des Schlüssels wird Owner.templatewählt die Vorlage:standard(Standard, wenn das Feld fehlt) oderverein; eine unbekannte Vorlage wird mit422am Feldtemplateabgelehnt, die Vorlage wirkt nur beim Anlegen.POST /api/rest/v1/communities/{slug}/adminsmitemail– gibt dem Konto mit dieser Adresse die Rolle Admin. Plattform-Admins dürfen auch Konten benennen, die noch nicht Mitglied sind: Sie werden direkt aktive Admins, ohne Beitrittsformular oder Freigabe. Das Konto muss es bereits geben (sonst404).
404 – so lässt sich nicht prüfen, ob es zu einer Adresse ein Konto gibt. Wer schon Admin ist, bleibt unverändert; Owner, gesperrte Mitglieder und offene Beitrittsanfragen ergeben 409. Eine Übergabe der Owner-Rolle gibt es über die API nicht.
Lesen oder lesen und schreiben
Beim Erzeugen wählst du den Zugriff des Schlüssels:- Nur lesen – alle
GET-Aufrufe. Jeder schreibende Aufruf (POST,PUT,DELETE) wird mit403abgelehnt, auch wenn das Konto ihn dürfte. Für Auswertungen und Abgleiche die sichere Wahl. - Lesen und schreiben – zusätzlich die Verwaltungsaktionen unten.
Was v1 kann
Nicht in v1: Beiträge, Kommentare, Nachrichten, Zahlungen und Rechnungen, Einstellungen (auch Dienst-Arten, Dienst-Slots und deren Buchung), Plattform-Verwaltung, Webhooks. Für Benachrichtigungen bei Ereignissen gibt es die Integrationen mit dem allgemeinen Webhook.
Geleistete Dienste bestätigen
Ab QuickTribe 2.37 kann eine Community festlegen, dass ein Dienst erst zählt, wenn das Team ihn bestätigt hat. Über die API erledigt das zum Beispiel ein Einlass- oder Zeiterfassungs-System, das weiß, wer wirklich da war:409); ein bestätigter Dienst ist endgültig. Wer einen schon bestätigten Dienst noch einmal bestätigt, bekommt ihn unverändert zurück (200). Das Mitglied wird wie sonst benachrichtigt, und jede Entscheidung steht im Protokoll.
Zwei Unterschiede zur Oberfläche: Dort bestätigen auch Moderatoren – ein API-Schlüssel braucht wie überall ein Konto, das Owner oder Admin ist (oder Plattform-Admin). Und ohne den Filter status liefert die Liste alle Zustände; als geleistet zählen nur Einträge mit counted: true.
Termine absagen
POST /api/rest/v1/communities/{slug}/events/{eventId}/cancel sagt einen Termin ab, …/reinstate nimmt die Absage zurück – mit denselben Regeln und Folgen wie in der Oberfläche: Zusagen bleiben gespeichert, die Angemeldeten werden benachrichtigt, der Eintrag im Protokoll nennt den API-Schlüssel.
occurrenceist Pflicht: der Beginn des Termins, wie ihn die Terminliste alsoccurrenceStartliefert. Bei Serien betrifft der Aufruf nur diesen einen Termin.reason(nur beim Absagen, optional): reiner Text bis 300 Zeichen – ihn lesen die Angemeldeten in Benachrichtigung und E-Mail.- Antwort ist der Termin (
cancelled,cancellationKind,cancellationReason,cancelledAt). 404 bei unbekanntem Event oder Termin, 409 bei einer Vorschau, einem beendeten Termin, einem schon abgesagten bzw. nicht abgesagten Termin, 422 ohneoccurrence. - Auch automatische Absagen (Mindestteilnehmerzahl nicht erreicht) nimmst du so zurück; die Mindestzahl wird für diesen Termin danach nicht noch einmal geprüft.
Datenschutz
Die API liefert nur, was Owner und Admins auch in der Oberfläche sehen. Geleistete Dienste nennen das Mitglied nur mit Anzeigename, Profilbild und Rolle – und die Begründung einer Ablehnung, die das Team selbst eingegeben hat. Nicht enthalten sind E-Mail-Adressen (das Mitgliederverzeichnis zeigt sie dem Team nicht), Geburtsdaten (höchstens die Altersgruppen-Abzeichen, die das Team sieht), Name und Anschrift von Communities, die sie nicht abfragen, Passwörter, Tokens und Zahlungsdaten. Über die API greift die Community selbst als Verantwortliche auf ihre Daten zu – sie ersetzt das Abrufen in der Oberfläche und gibt nichts an Dritte weiter. Wer die Daten an ein anderes System überträgt, ist dafür selbst verantwortlich (z. B. Auftragsverarbeitung mit dem CRM-Anbieter).Interaktive Doku
Jede Installation bringt ihre eigene, interaktive Beschreibung mit:- Swagger UI:
https://<deine-installation>/api/rest/docs– mit „Authorize“ trägst du deinen Schlüssel ein und probierst Aufrufe direkt im Browser aus (der Schlüssel bleibt nur in diesem Browser-Tab). - OpenAPI-Datei:
https://<deine-installation>/api/rest/docs.json– für Code-Generatoren, Postman, Insomnia oder Bruno.
API-Referenz
Die Referenz in der Navigation links (Gruppe API-Referenz) entsteht aus derselben OpenAPI-Beschreibung wie die interaktive Doku. Trage im Feld für den Server die Adresse deiner Installation ein (ohnehttps://), um Beispiele direkt auszuprobieren.