Externe API-Anbindungen (Verband-Wettkampfdaten) — Handbuch

Wo zu finden

Öffnen Sie Clubeinstellungen → Externe API-Anbindungen.

Nicht verwechseln: Diese Seite regelt, dass sich ClubManager selbst zu einer externen API eines Drittanbieters verbindet, um von dort Daten abzurufen (z.B. Wettkampfdaten eines Verbands). Der umgekehrte Fall — externe Plugins verbinden sich zu ClubManager — wird unter API-Zugänge konfiguriert.

Wofür ist das?

Über eine Anbindung ruft ClubManager Daten aus einer externen Instanz ab, z.B. Liga-Tabellen und Spielpläne von Ihrem Landesverband. Aktuell steht ein Anbieter zur Verfügung:

VLW-online / SAMS-Server (Volleyball-Wettkampfdaten): liefert Liga-Tabellen und Spielpläne. Es findet kein Mitgliederabgleich statt — die Anbindung betrifft ausschließlich Wettkampfdaten.

Neue Anbindung anlegen — Schritt 1: Zugangsdaten

Klicken Sie auf Neu und wählen Sie den Anbieter aus. Die Bezeichnung wird dabei automatisch mit dem Anbieternamen vorausgefüllt, lässt sich aber frei anpassen.
Tragen Sie den API-Host ein — nur der Host, ohne https:// und ohne Pfad (z.B. www.vlw-online.de). Über den Link API-Dokumentation neben dem Feld gelangen Sie direkt zur externen Doku des gewählten Anbieters.
Tragen Sie den API-Key ein, den Sie vom Anbieter (z.B. Ihrem Landesverband) erhalten haben.
Klicken Sie auf Verbindung testen.

Wichtig: Beim erstmaligen Anlegen speichert ein erfolgreicher Verbindungstest die Zugangsdaten sofort und leitet automatisch auf die Bearbeiten-Seite der neu angelegten Anbindung weiter — ein separates „Speichern" ist für diesen ersten Schritt nicht nötig. Schlägt der Test fehl, erscheint eine Fehlermeldung mit Details; es wird nichts gespeichert.

Schritt 2: Zuordnung

Dieser Abschnitt ist gesperrt, bis der Verbindungstest in Schritt 1 erfolgreich war — vorher zeigt er nur einen Platzhalter-Hinweis. Nach erfolgreichem Test erscheinen hier die anbieterspezifischen Zuordnungsfelder. Bei VLW-online/SAMS-Server ist das:

Unser Verein: durchsuchbares Auswahlfeld mit allen Vereinen, die über die angebundene Instanz sichtbar sind. Der zugehörige Verband wird automatisch aus dem gewählten Verein ermittelt — eine separate Verbandsauswahl ist nicht nötig.

Klicken Sie abschließend auf Speichern.

Bestehende Anbindung bearbeiten

Der Zeitpunkt des letzten erfolgreichen Verbindungstests wird oberhalb der Zuordnung angezeigt („Zuletzt erfolgreich getestet"). Ändern Sie API-Host oder API-Key, wird die Zuordnung erneut gesperrt, bis die Verbindung mit den neuen Zugangsdaten erneut erfolgreich getestet wurde.

Hinweis: Der Anbieter lässt sich nach dem Anlegen nicht mehr ändern — er ist auf der Bearbeiten-Seite gesperrt. Benötigen Sie einen anderen Anbieter, legen Sie eine neue Anbindung an und löschen Sie bei Bedarf die alte.

Anbindung löschen

Über Löschen in der Liste oder auf der Bearbeiten-Seite entfernen Sie eine Anbindung inklusive aller Zugangsdaten unwiderruflich.