Spielplan

Api Key

Grundsätzliches

URL Schema

http://api.zweite-basketball-bundesliga.de/spielplan_proa/8be6f5bc7a30937ccd761615142ad2e4
http://api.zweite-basketball-bundesliga.de/spielplan_prob-nord/8be6f5bc7a30937ccd761615142ad2e4
http://api.zweite-basketball-bundesliga.de/spielplan_prob-sued/8be6f5bc7a30937ccd761615142ad2e4

der erste Parameter ist die anzusprechende Schnittstelle, der zweite der API Key

Format

das Format ist JSON, hier die beispielhafte Ausgabe

{
    "data": {
        "league": "ProA",
        "season": "2014\/2015"
    },
    "1": {
        "datetime": 1411920000,
        "homeId": "481",
        "home": "TEAM EHINGEN URSPRING    ",
        "guestId": "488",
        "guest": "MLP Academics Heidelberg",
        "hPoints": null,
        "gPoints": null
    },
    "2": {
        "datetime": 1412359200,
        "homeId": "517",
        "home": "OeTTINGER Rockets Gotha",
        "guestId": "541",
        "guest": "RASTA Vechta",
        "hPoints": null,
        "gPoints": null
    },
    "3": {
        "datetime": 1412530200,
        "homeId": "438",
        "home": "Bike-Cafe Messingschlager Baunach",
        "guestId": "517",
        "guest": "OeTTINGER Rockets Gotha",
        "hPoints": null,
        "gPoints": null
    }
}

data gibt nochmal die Liga sowie die Saison aus. Die folgenden array's haben eine Numeric ID die dem Spieltag entspricht. datetime => Numeric, Unixtime homeID => Numeric, eindeutige ID des Hometeams home => VarChar, Name des Hometeams guestID => Numeric, eindeutige ID des Guestteams guest => VarChar, Name des Gastteams hPoints => Numeric, erzielte Punkte des Hometeams gPoints => Numeric, erzielte Punkte des Gastteams

Beispiel der Einbindung

ein Beispiel zum erzeugen einer HTML Tabelle in PHP

ACHTUNG: hier fehlen Checks, das Beispiel soll nur grundlegenden Umgang vermitteln nicht in produktiven Umgebungen dienen!

$url = "api.zweite-basketball-bundesliga.de";
$api = "spielplan_prob-nord";
$key = "8be6f5bc7a30937ccd761615142ad2e4";
$json = file_get_contents('http://'.$url.'/'.$api.'/'.$key);

//true wandelt in Array anstatt Object
$arr = json_decode($json, true);

//Tabelle mit Überschriften erstellen
echo "<table>";
echo "<th>
        <td>Spieltag</td>
        <td>Datum</td>
        <td>Uhrzeit</td>
        <td>Heim</td>
        <td>Gast</td>
        <td>Ergebnis</td>
      </th>";

//die array's durchgehen
foreach ($arr as $day => $data)
{
        //nur Numerische Arrays ausgeben
        if (is_numeric($day))
                if (is_array($data[0]))
                {
                        foreach ($data as $d)
                        {
                                echo "<tr>
                                        <td>".$day."</td>
                                        <td>".date("d.m.Y",$d["datetime"])."</td>
                                        <td>".date("H:i",$d["datetime"])."</td>
                                        <td>".$d["home"]."</td>
                                        <td>".$d["guest"]."</td>
                                        <td>".$d["hPoints"].":".$d["gPoints"]."</td>
                                      </tr>";
                        }
                }
                else
                echo "<tr>
                        <td>".$day."</td>
                        <td>".date("d.m.Y",$data["datetime"])."</td>
                        <td>".date("H:i",$data["datetime"])."</td>
                        <td>".$data["home"]."</td>
                        <td>".$data["guest"]."</td>
                        <td>".$data["hPoints"].":".$data["gPoints"]."</td>
                      </tr>";
}
//tabelle schließen
echo "</table>";

?>