API-Zugänge für externe Plugins — Handbuch

Wo zu finden

Öffnen Sie Clubeinstellungen → API-Zugänge.

Wofür sind API-Zugänge?

Über diese Seite erzeugen Sie Schlüssel, mit denen sich externe Plugins — z.B. eine Joomla-Komponente oder das WordPress-Plugin — bei der ClubManager-API anmelden und Daten Ihres Vereins abrufen können, etwa veröffentlichte Mannschaften für die eigene Vereins-Website.

Nicht verwechseln: Diese Seite regelt den Zugriff auf ClubManager von außen. Der umgekehrte Fall — ClubManager verbindet sich zu einer externen API eines Drittanbieters (z.B. eines Verbands) — wird unter Externe API-Anbindungen konfiguriert.

Neuen API-Zugang erzeugen

Klicken Sie oben rechts auf Neuen API-Zugang erzeugen.
Vergeben Sie eine Bezeichnung, unter der Sie den Zugang später wiedererkennen, z.B. „Joomla Produktivsystem" oder „Joomla lokal (Test)".
Klicken Sie auf Erzeugen.

Wichtig: Der erzeugte Schlüssel wird aus Sicherheitsgründen nur direkt nach dem Erzeugen im Klartext angezeigt und kann danach nicht mehr eingesehen werden. Kopieren Sie ihn sofort über den Button Kopieren und hinterlegen Sie ihn im externen Plugin. Geht der Schlüssel verloren, muss ein neuer Zugang erzeugt werden.

Verbindung für externe Plugins

Ein Plugin authentifiziert sich per HTTP-Header gegen die API:

Basis-URL: https://www.clubmanager.info/api/v1
Authentifizierung: Header Authorization: Bearer <API-Schlüssel>
Verbindungstest: GET /api/v1/ping

Bestehende Zugänge verwalten

Die Tabelle zeigt alle erzeugten Zugänge mit Bezeichnung, Erzeugungsdatum und letztem Nutzungszeitpunkt („Noch nie genutzt", falls das Plugin sich noch nicht verbunden hat). Über Widerrufen lässt sich ein Zugang sofort ungültig machen — das externe Plugin kann sich danach nicht mehr damit authentifizieren. Widerrufen ist jederzeit möglich, unabhängig von einem Abo.

API testen

Sobald mindestens ein Zugang erzeugt wurde, steht der Abschnitt API testen zur Verfügung. Er führt eine echte Anfrage gegen die eigene API aus — mit einem temporären Schlüssel, der direkt danach wieder gelöscht wird — und zeigt exakt, was ein externes Plugin zurückbekommen würde:

Wählen Sie im Dropdown Endpunkt einen der verfügbaren Aufrufe (Verbindungstest, Liste aller Mannschaften oder Detail einer einzelnen Mannschaft).
Bei „Mannschaft-Detail" wählen Sie zusätzlich die gewünschte Mannschaft aus.
Klicken Sie auf Anfrage ausführen.

Das Ergebnis zeigt HTTP-Status, verbleibendes Rate-Limit und die vollständige JSON-Antwort.

Hinweis: Jeder Zugang hat vollen Lesezugriff auf alle Vereinsdaten, die die API bereitstellt — es gibt keine einschränkbaren Berechtigungsstufen pro Zugang. Alle Zugänge eines Vereins teilen sich zudem ein gemeinsames Rate-Limit von 60 Anfragen pro Minute. Nur veröffentlichte Mannschaften sind über die API abrufbar, und Sichtbarkeits-Einstellungen (z.B. Fotos, Kader, Geburtsjahr) werden serverseitig respektiert.

Core-Abo

Neue API-Zugänge zu erzeugen ist ein Core-Abo-Vorteil. Ohne aktives Core-Abo ist der Button „Neuen API-Zugang erzeugen" deaktiviert. Bereits erzeugte Zugänge funktionieren jedoch unabhängig vom Abo-Status weiter — bestehende Integrationen brechen also nicht, wenn das Abo später endet. Widerrufen ist ebenfalls immer möglich.