KNVB Dataservice API

Dit is de documentatie voor KNVB Dataservice API. Ieder hoofdstuk geeft een korte beschrijving van de API call, een formele syntax van de call, een lijst met mogelijke input parameters, een lijst met output parameters, een of meer voorbeeld calls en een voorbeeld output.

2.2 Programma (1507 )

Beschrijving

Met deze call kan van het dmv. teamid doorgegeven team een lijst met het wedstrijd programma worden opgehaald. De parameter comptype is optioneel. De default is 'R'; soms doet een team niet mee aan een reguliere competitie, dan word de default successievelijk B, N of V. In de return parameter CompType word meegegeven voor welk competitie type het programma is, dit is handig als geen comptype aan de call word meegegeven (eg. laat API het zelf maar uitzoeken). weeknummer is ook optioneel, de default is de huidige week. Wanneer een weeknummer (1-52) word meegegeven zal de API de programmagegevens voor dat weeknummer retourneren. Een A als weeknummer levert alle beschikbare programmagegevens op.

De comptype parameter geeft aan voor welk competitie type de resultaten worden opgevraagd. Dit kunnen zijn:

De vriendschappelijke competities bestaan uit twee 'competities'. Sommige teams spelen officieel bij de KNVB in een vriendschappelijke competitie. Andere teams plannen via het beheer interface van KNVB Dataservices vriendschappelijke wedstrijden. Beide typen vriendschappelijke competitie wedstrijden worden terug gegeven als comptype=V.

Het programma is per weeknummer per seizoen, een seizoen loopt van week nummer 26 in het ene jaar tot weeknummer 26 in het volgende jaar. Wanneer het programma van week nummer 1 word opgevraagd is dit automatisch het programma van weeknummer 1 in het tweede halfjaar van het seizoen. Wanneer het programma van weeknummer 26 word opgevraagd is dit het programma van het eerste speelweekend in het eerste halfjaar van het seizoen.

Ter illustratie van het voorgaande, bij seizoen 2012/2013:

Beschikbaarheid

Syntax

http://api.knvbdataservice.nl/api/teams/<teamid>/schedule?[weeknummer=12][&comptype=R|B|N|V&]PHPSESSID=<12345>&hash=<abbccdde200394>

Input parameters

Output parameters

Output

{
    "errorcode":1000,"message":"Ok",
    "List":[{
    "MatchID":"9656197",
    "WedstrijdNummer":"5384",
    "Datum":"2015-10-18",
    "Tijd":"1400",
    "Verzameltijd":"",
    "ThuisClub":"Zilvermeeuwen 1",
    "ThuisLogo":"http:\/\/bin617.website-voetbal.nl\/sites\/voetbal.nl\/files\/knvblogos\/BBFX33T.jpg",
    "ThuisTeamID":"122561",
    "UitClub":"DCG 1",
    "UitLogo":"http:\/\/bin617.website-voetbal.nl\/sites\/voetbal.nl\/files\/knvblogos\/BBCY31B.png",
    "UitTeamID":"109254",
    "Bijzonderheden":"",
    "Scheidsrechter":"Andre, P.T.J.",
    "CompNummer":"W1-0512**-12-418659!",
    "CompType":"R",
    "WedstrijdDag":"7",
    "VeldKNVB":"veld 1",
    "VeldClub":"",
    "Kleedkamer_thuis":"",
    "Kleedkamer_uit":"",
    "Kleedkamer_official":""
},{
    "MatchID":"9656363",
    "WedstrijdNummer":"5550",
    "Datum":"2015-11-01",
    "Tijd":"1400",
    "Verzameltijd":"",
    "ThuisClub":"Hoofddorp s.v. 1",
    "ThuisLogo":"http:\/\/bin617.website-voetbal.nl\/sites\/voetbal.nl\/files\/knvblogos\/BBCY17B.png",
    "ThuisTeamID":"107028",
    "UitClub":"Zilvermeeuwen 1",
    "UitLogo":"http:\/\/bin617.website-voetbal.nl\/sites\/voetbal.nl\/files\/knvblogos\/BBFX33T.jpg",
    "UitTeamID":"122561",
    "Bijzonderheden":"",
    "Scheidsrechter":"Dokkum, L.O. van",
    "CompNummer":"W1-0512**-12-418659!",
    "CompType":"R",
    "WedstrijdDag":"8",
    "VeldKNVB":"veld 1",
    "VeldClub":"",
    "Kleedkamer_thuis":"",
    "Kleedkamer_uit":"",
    "Kleedkamer_official":""
}]
}