 |
Hilfe für Webmaster
Mit Hilfe von Webservices kannst du als Webmaster deiner eigenen (Vereins-)Website Daten von ANNE, also zum Beispiel Meldungen deines Vereins für eine bestimmte Veranstaltung, auf deiner Seite integrieren.
Der Aufruf der Webservices erfolgt durch den Parameter ws mit dem Webservice-Namen und den weiteren Parametern wie sie für jeden Webservice spezifiziert sind, also zum Beispiel:
https://www.oefol.at/anne/?ws=getEntries&cid=19&eid=17
Als Ergebnis liefert jeder Webservice in den ersten Zeile einen Code zurück und in den folgenden Zeilen die Daten (falls vorhanden). Diese Codes sind wie folgt spezifiziert:
780 |
Webservice nicht gefunden |
781 |
Parameterliste nicht korrekt |
782 |
Keine Ergebnisse gefunden |
783 |
Ok |
Hier ein Beispiel in PHP, wie du die Webservices verwenden kannst. Dieses Beispiel ruft den Webservice "getEntries" auf, der als Parameter cid (ID des Vereins) und eid (ID der Veranstaltung) benötigt. <?php
$url = "https://www.oefol.at/anne"; //url
$ws = "getEntries"; //webservice name
$cid = "19"; //club id
$eid = "17"; //event id
//call webservice
$content = file_get_contents("$url/?ws=$ws&cid=$cid&eid=$eid");
//split lines
$lines = explode("\r\n",$content);
//check if webservice was found
if($lines[0]!=780){
//check if parameters are correct
if($lines[0]!=781){
//check if result is not empty
if($lines[0]!=782){
//print table header
echo "<table><tr>";
echo "<td><b>User id</b></td>";
echo "<td><b>Firstname</b></td>";
echo "<td><b>Lastname</b></td>";
echo "<td><b>SPORTident</b></td>";
echo "<td><b>World ranking id</b></td>";
echo "<td><b>Fee</b></td>";
echo "<td><b>Note</b></td>";
echo "<td><b>Out of competition</b></td>";
echo "<td><b>Category</b></td>";
echo "</tr>";
for($i=1;$i<count($lines);$i++){ //leave out first line
//split values
$values = explode("\|",$lines[$i]);
//print lines
echo "<tr>";
echo "<td>{$values[0]}</td>";
echo "<td>{$values[1]}</td>";
echo "<td>{$values[2]}</td>";
echo "<td>{$values[3]}</td>";
echo "<td>{$values[4]}</td>";
echo "<td>{$values[5]}</td>";
echo "<td>{$values[6]}</td>";
echo "<td>{$values[7]}</td>";
echo "<td>{$values[8]}</td>";
echo "</tr>";
}
//print table footer
echo "</table>";
}else{
//result is empty
echo "result is empty";
}
}else{
//parameters missing
echo "parameters missing";
}
}else{
//webservice not found
echo "webservice not found";
}
?>
Hier findest du alle verfügbaren Webservices mit Beschreibungen, notwendigen Parametern und zurückgegebenen Ergebnissen.
getEntries
Beschreibung:
Gibt alle Meldungen eines bestimmten Vereins für eine bestimmte Veranstaltung zeilenweise zurück, sortiert nach Nachname aufsteigend und Vorname aufsteigend.
Parameter:
cid - ID des Vereins
eid - ID der Veranstaltung
Ergebnis:
Details zu den Meldungen durch | getrennt, pro Zeile eine Meldung, in folgender Reihenfolge:
- ID der Person (Integer)
- Vorname der Person
- Nachname der Person
- SPORTident der Meldung
- World ranking ID der Meldung
- Startgeld (Double) für diese Meldung
- Anmerkung zur Meldung
- Außer Konkurrenz (0=nein, 1=ja)
- Kategorie-Name
getEventDetails
Beschreibung:
Gibt Details zu einer bestimmten Veranstaltung zurück.
Parameter:
id - ID der Veranstaltung
Ergebnis:
Details zu der Veranstaltung durch | getrennt in folgender Reihenfolge:
- ID der Veranstaltung (Integer)
- Name des durchführenderen Vereins
- Datum der Veranstaltung (UNIX Zeitstempel)
- Meldeschluss (UNIX Zeitstempel)
- Datum, an dem die Benachrichtigung gesendet wird (UNIX Zeitstempel)
- Nachmeldeschluss (UNIX Zeitstempel)
- Veranstaltungsname
- Kurztitel der Veranstaltung
- Ort der Veranstaltung
- Veranstaltungstyp (0=Einzelwettkampf, 1=Staffel, 2=Mannschaft)
- World ranking event (0=nein, 1=ja)
- Sportart (1=Orientierungslauf, 2=Mountain bike orienteering, 3=Ski Orientierungslauf, 4=Trail orienteering
- Benachrichtigung gesendet (0=nein, 1=ja)
getEvents
Beschreibung:
Gibt alle Veranstaltungen in einem bestimmten Zeitraum zeilenweise zurück, sortiert nach Veranstaltungstag aufsteigend und Titel aufsteigend.
Parameter:
dateFrom - Beginn des Zeitraums (UNIX Zeitstempel) [optional]
dateTo - Ende des Zeitraums (UNIX Zeitstempel) [optional]
Ergebnis:
Details zu den Veranstaltungen durch | getrennt, pro Zeile eine Veranstaltung, in folgender Reihenfolge:
- ID der Veranstaltung (Integer)
- Name des durchführenderen Vereins
- Datum der Veranstaltung (UNIX Zeitstempel)
- Meldeschluss (UNIX Zeitstempel)
- Datum, an dem die Benachrichtigung gesendet wird (UNIX Zeitstempel)
- Nachmeldeschluss (UNIX Zeitstempel)
- Veranstaltungsname
- Kurztitel der Veranstaltung
- Ort der Veranstaltung
- Veranstaltungstyp (0=Einzelwettkampf, 1=Staffel, 2=Mannschaft)
- World ranking event (0=nein, 1=ja)
- Sportart (1=Orientierungslauf, 2=Mountain bike orienteering, 3=Ski Orientierungslauf, 4=Trail orienteering
- Benachrichtigung gesendet (0=nein, 1=ja)
|