Ergebnisschnittstelle/DVL
Inhaltsverzeichnis |
Allgemeines
Die DVL bietet ihren Mitgliedern eine Schnittstelle an, um Ergebnisse, Spielpläne und Tabellen auf der eigenen Homepage einzubinden.
Robert Köhring (Netzhoppers KW) hat eine PHP-Funktion zum Import dieser XML-Daten und deren Überführung in HTML-Elemente geschrieben, die er allen DVL-Mitgliedsvereinen freundlicherweise zur Verfügung stellt. Beschreibung und Download gibt es auf der Unterseite Ergebnisschnittstelle/DVL/PHP.
Ebenso steht inzwischen ein Modul zur Verfügung, mit dem sich die XML-Schnittselle in Joomla einbinden lässt. Beschreibung und Download gibt es auf der Unterseite Ergebnisschnittstelle/DVL/Joomla.
Zur Verwendung in Typo3 gibt es Hinweise auf der Diskussionsseite.
Technische Beschreibung
Die Schnittstelle ist über eine extra eingerichtete Subdomain erreichbar. Hier muss ein Script aufgerufen werden, das die Daten in "nacktem" XML-Format erzeugt.
Die URL der Schnittstelle lautet:
Um korrekt arbeiten zu können, benötigt die Schnittstelle Parameter, die ihr mitteilen, welche Informationen geliefert werden sollen.
Parameter 1: Kennung (zwingend erforderlich)
- Die Kennung besteht aus einem gültigen, zehnstelligen Code. Die Eingabe ist case-sensitive und der Parameter zwingend erforderlich.
- Beispiel: http://interface.dvl-datenbank.de/givemedata.php?kennung=xxxxxxxxxx
- Eine individuelle Kennung kann per E-Mail an info@volleyball-bundesliga.de angefordert werden
Parameter 2: Job (zwingend erforderlich)
- Dieser Parameter steuert zunächst - sozusagen auf oberster Ebene-, welche Information geliefert werden soll. Die Angabe dieses Parameters ist zwingend erforderlich. Es stehen vier Werte des Parameters zur Verfügung, die selbsterklärend die Informationsart beschreiben:
- spielplan
- ergebnisse
- tabelle
- allgemein
Optionale Parameter
- Der Job-Parameter kann mit (bis auf eine Ausnahme) optionalen Parametern ergänzt werden, die das Ergebnis spezifizieren bzw. einschränken.
- Die Reihenfolge der genannten Parameter spielt keine Rolle.
| Parametername | verfügbar mit Job... | Werte | |||
| spielplan | ergebnisse | tabelle | allgemein | ||
| liga | x | x | x | bl1m, bl1f, bl2nm, bl2nf, bl2sm, bl2sf (1) | |
| liga | x | playdown | |||
| liga | x | x | pokm, pokf | ||
| mannschaft | x | x | Name der Mannschaft (1) | ||
| teamid | x | x | ID der Mannschaft (1) | ||
| datum | x | x | Datum im Format tt.mm.jjjj | ||
| spielnr | x | x | Spielnummer des Spiels | ||
| info (erforderlich) | x | "teams" oder "liga" | |||
(1): Um an die Information der korrekten Ligabezeichnungen, Mannschaftsnamen und Mannschafts-IDs, die von der Schnittstelle verwendet werden, zu gelangen, wurde der Job "allgemein" eingeführt. Kombiniert mit dem Parameter "info" und dem gewünschten Wert, erhält man die notwendigen Informationen.
- liefert die korrekten Ligabezeichnungen
- liefert die korrekten Mannschaftsnamen und Mannschafts-ID. ACHTUNG: Die Mannschafts-ID ändert sich bei Saisonwechsel!
Beispiele für die Kombination von Parametern
- liefert den kompletten Spielplan der 1. Bundesliga Männer
- liefert alle Ergebnisse des Schweriner SC in der 1. Bundesliga Frauen
- liefert die Tabelle der 2. Bundesliga Süd Männer
- liefert alle Spielansetzungen am 10.10.2009 für die 1. Bundesliga Männer
- liefert den Spielplan für die Mannschaft SCC Berlin
Weiterführende Links
Best Practice Beispiele
- SCC Berlin | Ergebnisse und Tabelle auf Startseite
- Fanclub Netzinos | Tabelle auf Startseite Spielplan Tabelle
- Wuppertal Titans | Tabelle Ergebnisse
- VfB Suhl | Tabelle
- Netzhoppers KW | Termmine Netzhoppers KW | Termine Netzhoppers KW | Tabelle
- VC Franken | Ergebnisse
