Kurzanleitung für Clubs

Über die Club-Schnittstelle (Club-API) bettest du aktuelle Statistiken deines Clubs direkt auf deiner eigenen Website ein: Ranglisten, Topscorer- und Torhüter-Wertungen, Resultate sowie Spielpläne. Jede dieser Auswertungen ist ein sogenanntes Statistik-Widget. Du konfigurierst es in MySIHF und rufst es danach über eine feste URL ab, entweder als fertiges HTML-Widget für einen iframe oder als XML-Rohdaten für die eigene Weiterverarbeitung.

Wer darf das?

• Clubadministrator, oder
• Rolle Club-API

Die Club-Schnittstelle ist eine Einstellung auf Clubebene. Als Clubadministrator findest du sie unter Einstellungen neben deinen übrigen Menüpunkten. Der Zugriff kann aber auch separat vergeben, über die Rolle Club-API. Ein solches Konto sieht in der ganzen Anwendung ausschliesslich den Menüpunkt Club-Schnittstelle, sonst nichts. Das erkennst du oben links im Rollen-Switcher: dort steht anstelle einer üblichen Clubrolle Club-API, darunter der Club, für den das Konto freigeschaltet ist (z. B. «102024 | EHC Burgdorf»). So lässt sich der Zugriff auf die Widget-Verwaltung erteilen, ohne gleich die volle Clubadministration freizugeben.

In beiden Fällen gilt dieselbe Voraussetzung: erst muss Swiss Ice Hockey die Club-API für den Club freischalten (siehe unten).

Das Wichtigste in Kürze

• Die Club-API muss für deinen Club freigeschaltet werden. Das macht Swiss Ice Hockey, nicht der Club selbst.
• Ohne Freischaltung siehst du den Menüpunkt nicht, egal ob du dich als Clubadministrator oder mit einem Club-API-Konto anmeldest.
• Nach der Freischaltung findest du alles unter Einstellungen → Club-Schnittstelle.
• Dort verwaltest du beliebig viele Statistik-Widgets: erstellen, ansehen, Einbettungscode kopieren, Vorschau prüfen.

1. Zugang beantragen

Die Club-API ist nicht automatisch für jeden Club aktiv. Wenn dein Club die Schnittstelle nutzen möchte, geh so vor:

1. Melde dich bei Swiss Ice Hockey, am einfachsten per E-Mail an support@sihf.ch oder über den Hilfe-Button im System. Gib dabei den Namen, Nummer und zwei unterschriftberechtigte Personen deines Clubs an.
2. Swiss Ice Hockey wird Dir einen Vertrag zuschicken, welcher die Benutzung der Daten regelt und welchen ihr unterschreiben müsst. Die Kosten betragen einmalig CHF 300.- (exkl. MWSt.), danach CHF 130.-/Saison.
3. Swiss Ice Hockey aktiviert anschliessend die Club-API für deinen Club im Hintergrund.
4. Sobald die Freischaltung erfolgt ist, erscheint bei dir im Menü unter Einstellungen (rechts oben) neu der Punkt Club-Schnittstelle.

Zeigt dir der Menüpunkt Einstellungen → Club-Schnittstelle (als Clubadministrator), oder dein Club-API-Konto den Hinweis «Die Club-Schnittstelle ist für deinen Club nicht aktiviert. Bitte melde dich bei der SIHF (support@sihf.ch).», ist die Club-API für deinen Club noch nicht aktiviert. Wende dich in diesem Fall an Swiss Ice Hockey.

2. Wo finde ich die Club-Schnittstelle?

Nach der Freischaltung:

1. Öffne im Hauptmenü Einstellungen (als Clubadministrator) beziehungsweise melde dich mit deinem Club-API-Konto an, dort ist der Menüpunkt direkt sichtbar.
2. Wähle den Menüpunkt Club-Schnittstelle (Symbol: Widgets).

Du landest auf der Seite «Club-Schnittstelle: Statistik-Widgets», der Übersichtsseite deiner Statistik-Widgets.

3. Was sehe ich dort?

Die Seite zeigt dir zwei Bereiche:

Die Widget-Liste. Eine Tabelle mit allen Statistik-Widgets, die dein Club bereits angelegt hat. Jede Zeile trägt eine fortlaufende Nummer und einen eindeutigen Aufruf-Schlüssel (KeyId). Die Nummer nennst du bei Rückfragen an Swiss Ice Hockey, damit dein Widget schnell gefunden wird. Über ein Symbol neben dem Aufruf-Schlüssel kopierst du die Einbettungs-URL direkt.

Die Schaltfläche «Statistik-Widget hinzufügen». Damit legst du ein neues Widget an. Im Formular wählst du unter anderem:

• welches Team und welche Spielphase die Statistik betrifft,
• welche Statistik angezeigt wird (zum Beispiel Rangliste, Topscorer, Torhüter-Wertung, aktuelle oder nächste Spiele),
• das Ausgabeformat (HTML für den iframe, XML für eigene Weiterverarbeitung),
• Sprache und Saison des Widgets.

Nach dem Speichern zeigt das Formular dir die fertige Einbettungs-URL und den passenden iFrame-Code, dazu eine Vorschau, bevor du das Widget auf deiner Website einbindest.

Für die Konfiguration der einzelnen Felder und Statistik-Typen im Detail gibt es die separate, ausführliche Anleitung «Club-Schnittstelle - Anleitung» von Swiss Ice Hockey. Diese hier soll dir nur zeigen, wie du überhaupt Zugang erhältst und wo du danach ansetzt.

Support

Bei Fragen zur Freischaltung oder zu einem bestehenden Widget wende dich an:

• E-Mail:support@sihf.ch, Ticket wird automatisch eröffnet.
• Nenne dabei möglichst die Nummer des betroffenen Widgets aus der Widget-Liste.