Automatisierungen
Webhooks und API-Schlüssel, um den Verein mit Diensten wie Zapier, n8n oder eurer eigenen Software zu verbinden.
Unter Admin → Automatisierungen verbindest du euren Verein mit anderen Systemen. Die Seite hat zwei Bereiche:
- Webhooks melden Ereignisse wie neue Buchungen oder Platzsperren sofort an eine Adresse deiner Wahl. Wie das geht, steht unter Webhooks.
- API-Schlüssel erlauben einer Integration, über die REST-API auf die Daten eures Vereins zuzugreifen.
Freischaltung durch den Support
Webhooks und API-Schlüssel sind Zusatzfeatures und standardmäßig aus. Wenn ihr sie nutzen möchtet, schreib an den Support. Der Eintrag Automatisierungen erscheint, sobald mindestens eines davon freigeschaltet ist und du die passenden Rechte hast. Jeder Bereich erscheint nur, wenn er freigeschaltet ist.
Für fertige Anbindungen von Anbietern, etwa für Türschlösser oder die Buchhaltung, gibt es Apps. Sie brauchen weder Webhooks noch API-Schlüssel.
API-Schlüssel
Ein Management-Schlüssel gehört dem Verein, nicht einer Person. Eine Integration, die ihn nutzt, arbeitet also weiter, auch wenn die Person, die ihn erstellt hat, den Verein verlässt. Den Bereich sieht, wer das Recht hat, API-Schlüssel zu verwalten.
Schlüssel erstellen
- Klicke auf Neuen Schlüssel erstellen.
- Gib eine Bezeichnung ein, etwa „Webseiten-Integration“.
- Wähle bei Bedarf ein Ablaufdatum (optional). Danach funktioniert der Schlüssel nicht mehr.
- Wähle unter Berechtigungen, was der Schlüssel darf. Die Rechte sind nach Bereichen gruppiert, mit Alle wählst du einen ganzen Bereich. Du kannst nur Rechte vergeben, die du selbst hast. Gib dem Schlüssel nur, was die Integration wirklich braucht.
- Klicke auf Erstellen.
CheckCourt zeigt den Schlüssel danach nur dieses eine Mal an. Er beginnt mit
ck_mgmt_. Kopiere ihn, hinterlege ihn in der Integration und bestätige mit Ich habe
den Schlüssel gespeichert. Geht er verloren, erstellst du einen neuen.
Schlüssel im Blick behalten
Die Liste zeigt jeden aktiven Schlüssel mit Bezeichnung, den ersten Zeichen des Schlüssels, wann er erstellt und zuletzt verwendet wurde, wann er abläuft und welche Rechte er hat.
Schlüssel widerrufen
Klicke beim Schlüssel auf Widerrufen und bestätige mit Wirklich?. Der Schlüssel funktioniert sofort nicht mehr und steht danach unter Widerrufen. Widerrufen kannst du nur Schlüssel, deren Rechte du alle selbst hast.
Erstellen und Widerrufen stehen im Aktivitätsprotokoll. Was eine Integration mit dem Schlüssel tut, erscheint dort unter dem Namen des Schlüssels.
Wie Entwickler mit dem Schlüssel arbeiten, steht im Developer-Bereich.