Der Steirische Fußballverband informiert...

Vereinsdatenservice Schnittstelle

1 Allgemeines

fussballoesterreich.at stellt mit der Verlinkung der Vereinsdaten den Vereinen (ausschließlich
Vereinen!) ein Service zur Verfügung, das zur Verlinkung der aktuellen Tabellen, Spielpläne und
Torschützenliste in der eigenen Homepage verwendet werden kann.
Dieses Service ersetzt das bisherige "Vereinsdatenservice", das per 30.6.2013 eingestellt wird. Es
bietet wesentlich mehr und flexiblere Integrationsmöglichkeiten und auch die Möglichkeit, die
mobile Vereins-App einzubinden.
Wesentlich ist dabei:
• Die Einbindung in der jeweiligen Seite muss korrekt (d.h. nach den entsprechenden
Vorgaben) erfolgen. Bei Verstößen kann die Nutzung von fussballoesterreich.at unterbunden
werden.
• fussballoesterreich.at stellt dieses Service freiwillig, widerruflich und ohne jegliche Gewähr
zur Verfügung gestellt wird. fussballoesterreich.at kann das Service jederzeit und ohne
Vorankündigungen einstellen, insbesondere auch dann wenn die Stabilität oder Performance
des Gesamtsystems beeinträchtigt werden.
• Die von fussballoesterreich.at verwendeten Daten unterliegen den Nutzungsbedingungen
von fussballoesterreich.at sowie denen des jeweiligen Landesverbandes. Alle übertragenen
Seiten enthalten einen entsprechenden Copyright-Hinweis.
• Die Daten dürfen auf Basis dieser Schnittstelle ausschließlich online referenziert werden. Sie
dürfen nicht kopiert, weiterverarbeitet in irgend einer Weise verändert oder anderweitig
genutzt werden. Die Nutzung darf nur auf Basis der beschriebenen Schnittstelle erfolgen.
Jede Weitergabe der Daten sowie jede über die bloße Anzeige der Daten hinaus reichende
Bearbeitung oder Verwendung bedarf der schriftlichen Zustimmung des jeweiligen
Landesverbands.
• Die Einbindung darf nur in der dokumentierten Art erfolgen. Dabei muss in jedem Fall ein
eigenes Fenster geöffnet werden. Eine Einbindung via IFrame bzw. durch direktes Einbetten
der entsprechenden Daten in eigene Seiten ist nicht erlaubt.
Mit der Nutzung des Datenservices können Berechtigte (Berechtigte sind etwa: Vereine, Verbände oder all jene, denen der zuständige Landesverband das entsprechende
Recht eingeräumt hat.) "fertige" (=aufbereitete) Fußball-Daten
(Ergebnisse, Tabellen, Torschützenlisten, Link auf die Vereins-App etc.) online auf eigenen
Homepages verlinken. So lassen sich die aktuellen Tabellen, Karten, die Torschützenlisten oder der
Spielplan einfach in der eigenen Homepage einbinden. Dazu braucht der betreffende Webmaster des
Vereins nur den Anweisungen in diesem Dokument zu folgen und die entsprechenden Verlinkungen
auf der eigenen Homepage durchführen.
Anmerkung: für die Nutzung in anderen Medien gibt es eine eigene, asynchrone Schnittstelle
(Achtung: nicht Online).
 

2 Verlinkung


2.1 Einbau der Links
Die Datenservice-Schnittstelle verlinkt immer auf die Daten der aktuellen Saison. Die Einbindung
der Links auf der jeweiligen Vereinsseite ist ein simpler HTML Link, beispielsweise
folgendermaßen:
<a href="[...hier steht der Link...]" target=" fussballoesterreich-daten">Tabelle</a>
Wichtig ist, dass die Seiten ausschließlich extern aufgerufen werden dürfen. Es ist keine Integration
via IFrame möglich. Anstelle von "fussballoesterreich-daten" kann auch ein eigener Name bzw.
"_blank" verwendet werden. Die Verwendung von Deep-Linking wird nur bei
fussballoesterreich.at-Homepages unterstützt. Bei anderen Seiten kann eine Umleitung auf die
Startseite von fussballoesterreich.at erfolgen.
2.2 Aufbau der Links
Alle Links, die man zum Verlinken benötigt, sind nach einem Baukastenprinzip aufgebaut.
Teil 1:
Alle Links beginnen mit http://vereine.fussballoesterreich.at/vereinsdaten/VEREINSNUMMER
Am Beispiel von Union Neustift/Oberkappel http://vereine.fussballoesterreich.at/vereinsdaten/4104
Teil 2:
An zweiter Stelle wird entweder ein Teilbereich der Vereinshomepage angegeben oder die
Mannschaftsbezeichnung.
Mögliche Teilbereiche: news, verein, funktionaere, trainer, sponsoren, sportplatz, termine, app
Mannschaftsbezeichnung (Sämtliche Sonderzeichen (zB. Umlaute, Leerzeichen) müssen Url codiert werden (UTF-8)) : zB. KM, KM-Fr, U19, U16, U12+A (Sonderzeichen "Leerzeichen" wird UTF-8 Url codiert zu "+")... (siehe Reiter "Mannschaften" in
Fußball Online, Spalte Bezeichnung "Bez.")
Beispiel: http://vereine.fussballoesterreich.at/vereinsdaten/4104/verein
Teil 3 (nur bei Mannschaftsbezeichnung):
Bei Mannschaften kann der entsprechende Teilbereich angegeben werden.
Mögliche Teilbereiche: tabellen, spiele, kader, torschuetzen, kartenstatistik
Beispiel: http://vereine.fussballoesterreich.at/vereinsdaten/4104/KM/tabellen
http://vereine.fussballoesterreich.at/vereinsdaten/4104/U12+A/kader
Beispiele für die Verlinkung auf die Vereinshomepage:
http://vereine.fussballoesterreich.at/vereinsdaten/4104
http://vereine.fussballoesterreich.at/vereinsdaten/4104/news
http://vereine.fussballoesterreich.at/vereinsdaten/4104/app
http://vereine.fussballoesterreich.at/vereinsdaten/4104/verein
http://vereine.fussballoesterreich.at/vereinsdaten/4104/funktionaere
http://vereine.fussballoesterreich.at/vereinsdaten/4104/trainer
http://vereine.fussballoesterreich.at/vereinsdaten/4104/sponsoren
http://vereine.fussballoesterreich.at/vereinsdaten/4104/sportplatz
http://vereine.fussballoesterreich.at/vereinsdaten/4104/termine
Beispiele für die Verlinkung der Kampfmannschaft:
http://vereine.fussballoesterreich.at/vereinsdaten/4104/KM/tabellen
http://vereine.fussballoesterreich.at/vereinsdaten/4104/KM/spiele
http://vereine.fussballoesterreich.at/vereinsdaten/4104/KM/kader
http://vereine.fussballoesterreich.at/vereinsdaten/4104/KM/torschuetzen
http://vereine.fussballoesterreich.at/vereinsdaten/4104/KM/kartenstatistik

3 Fehlerquellen

Die Verwendung der Schnittstelle ist sehr einfach. Dennoch gibt es einige bekannte Fallstricke-
Diese sind:
● Nicht richtige Url Codierung von "Sonderzeichen" wie Umlauten, Leerzeichen, etc. Dazu
gibt es Werkzeuge, die entsprechende Texte "richtig" übersetzen ("URL Encoding UTF-8",
einfach etwa via Google Suche auffindbar).
zB. Leerzeichen wird Url codiert zu einem "+" (d.h. die Mannschaftsbezeichnung "U12 A"
kann mit der Url "U12+A" verlinkt werden.
● Namensänderungen: Selten, aber doch, kann es passieren, dass Namen zentral geändert
werden (Bezeichnung der Mannschaft; in der Regel vor Saisonstart). In diesem Fall können
Links ungültig werden und müssen manuell korrigiert werden.