Um den Webservice nutzen zu können, muss eine Registrierung vorgenommen werden, da bei jeder Anfrage an den Service gültige Authentifizierungsdaten erforderlich sind. Die Daten Username und Passwort werden dem Antragsteller nach Ausfüllen dieses Formulars zugestellt:

Die Nutzung dieser Daten ist ausschliesslich für die Integration in Webseiten gestattet. Nicht gestattet ist die Nutzung dieser Daten für Mobile online Applikationen (Apps). Die Nutzung der Daten zu kommerziellen Zwecken, egal welcher Art, ist ohne die vorgängig eingeholte schriftliche Genehmigung von swiss unihockey nicht erlaubt. Bei Verstoss gegen vorstehende Bestimmungen behält sich swiss unihockey vor, rechtliche Schritte einzuleiten.

Ebenfalls zwingend ist die Registrierung auf der Mailingliste "webservices". Swiss unihockey informiert dort über geplante Änderungen und Erweiterungen des Services, kündigt Betriebsunterbrüche an und beantwortet Anfragen im Zusammenhang mit der Dienstleistung.

Bitte beachten Sie, dass die Mailingliste über eine Archiv-Funktion verfügt. Dort finden Sie Informationen zur Einbindung und Verwendung der Services.

Es stehen mehrere sogenannte Endpoints zur Abfrage von Daten zur Verfügung. Das Angebot umfasst momentan Vereine, Teams, Ligastruktur und Spiele.

Um die Einbindung zu vereinfachen, enthält jeder Endpoint eine Dokumentationsseite, welche für jede Methode ein geeignetes HTML-Formular bereitstellt. Auf diese Weise können sowohl manuelle Abfragen gemacht werden, als auch die zur Verfügung stehenden Parameter getestet werden.

Um anstelle von XML das ebenfalls gebräuchliche JSON-Antworformat zu erhalten, muss beim Request der "Accept"-Header mit einem Wert von "application/json" gesetzt werden.

Aufgrund von beschränkten Ressourcen ist es swiss unihockey im Moment nicht möglich, Beispielcode für verschiedene Programmiersprachen zur Verfügung zu stellen. Gerne sind wir jedoch bereit, von Nutzern zur Verfügung gestellte Beispiele hier zum Download anzubieten.

Um zu verhindern, dass auf der oben beschriebenen Mailingliste immer wieder dieselben Fragen gestellt werden, haben wir auf der folgenden Seite Antworten auf häufig gestellte Fragen zusammengestellt. Bitte prüfen Sie, ob die Frage, die sie stellen möchten nicht bereits beantwortet wurde, bevor Sie diese auf der Mailingliste posten.

Gerne nehmen wir Beiträge zu Service-Dokumentation, Tutorials, Beispiel-Code etc. auf der Mailingliste entgegen.