Voetbal Datacentre API

Dit is de documentatie voor Voetbal Datacentre 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.

3.1 Wedstrijd Listing (1507 )

Beschrijving

Met deze call kan een listing van wedstrijden van de hele club worden opgehaald. Het weeknummer is optioneel. Als het weeknummer niet wordt doorgegeven wordt een listing van de laatste 5 dagen doorgegeven. Als deze call bijvoorbeeld op woensdag wordt gedaan worden zaterdag, zondag, maandag, dinsdag en woensdag doorgegeven. Op zaterdag worden dinsdag, woensdag, donderdag, vrijdag en zaterdag doorgegeven.
Een A als weeknummer levert alle beschikbare programmagegevens op.

De parameter zaalveld is optioneel. De default is leeg, hierdoor worden alle wedstrijden teruggegeven.De mogelijkheden voor zaalveld zijn zaal of veld.

De parameter comptype is optioneel. De default is leeg, hierdoor worden alle competities teruggegeven.De mogelijkheden voor comptype zijn R, B, N of V.

De parameter order is optioneel. De default is leeg, hierdoor worden alle wedstrijden op sterkte van competitie teruggegeven. Als de optie time wordt meegegeven, dan zijn de wedstrijden gesorteerd op tijd.

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

R: reguliere competitie
B: beker competitie
N: nacompetitie
V: vriendschappelijke competitie (KNVB of voetbaldatacentre)

Vriendschappelijke wedstrijden krijgen automatisch een V voor het WedstrijdNummer.

Beschikbaarheid

API: U heeft een API sleutel nodig.

Syntax

https://api.voetbaldatacentre.nl/api/wedstrijden?[weeknummer=12&][zaalveld=zaal&][comptype=R|B|N|V&][order=time&]PHPSESSID=<12345>&hash=<abbccdde200394>

Input parameters

PHPSESSID: Session ID verkregen uit initialisatie
hash: Hash berekend aan client side
weeknummer: week waarvan de wedstrijden worden opgehaald (1-52, A) (optioneel)
zaalveld: of zaalwedstrijden of veldwedstrijden worden opgehaald (optioneel)
comptype: competitietype waarvan de wedstrijden worden opgehaald (optioneel)
order: in welke volgorde de wedstrijden terug gegeven moeten worden (optioneel)

Output parameters

lijst: lijst met wedstrijden bestaande uit de velden Datum, Tijd, Verzameltijd, ThuisLogo, ThuisClub, ThuisClubNummer, ThuisTeamId, UitLogo, UitClub, UitClubNummer, UitTeamId, Scheidsrechter, Hulpscheidsrechter1, Hulpscheidsrechter2, Facility_Id, Facility_naam, Facility_Stad, Facility_Postcode, Facility_Adres, Aantal_Fotos, Aantal_Videos, Aantal_Reacties, Overzicht_Reacties, PuntenTeam1, PuntenTeam2, PuntenTeam1Verl, PuntenTeam2Verl, PuntenTeam1Strafsch, PuntenTeam2Strafsch, Competitie, District, CompId, ClassId, PouleId, CompType, WedstrijdDag, Zaalveld, MatchID, WedstrijdNummer, Bijzonderheden, VeldKNVB, VeldClub, Kleedkamer_thuis, Kleedkamer_uit, Kleedkamer_official

Output

{
    "errorcode":1000,"message":"Ok",
    "List":[{
    "Datum":"2015-10-17",
    "Tijd":"1100",
    "Verzameltijd":"",
    "ThuisLogo":"http:\/\/bin617.website-voetbal.nl\/sites\/voetbal.nl\/files\/knvblogos\/BBFX33T.jpg",
    "ThuisClub":"Zilvermeeuwen D1",
    "ThuisClubNummer":"BBFX33T",
    "ThuisTeamId":"122572",
    "UitLogo":"http:\/\/bin617.website-voetbal.nl\/sites\/voetbal.nl\/files\/knvblogos\/BBDB38C.png",
    "UitClub":"Buiksloot D2",
    "UitClubNummer":"BBDB38C",
    "UitTeamId":"111220",
    "Scheidsrechter":"",
    "HulpScheidsrechter1":"",
    "HulpScheidsrechter2":"",
    "Facility_Id":"BBGF075",
    "Facility_naam":"Sportpark Poelenburg- Z'meeuwen",
    "Facility_Stad":"ZAANDAM",
    "Facility_Postcode":"1504NW",
    "Facility_Adres":"Poelenburg 464",
    "Aantal_Fotos":"0",
    "Aantal_Videos":"0",
    "Aantal_Reacties":"",
    "Overzicht_Reacties":"",
    "PuntenTeam1":"NULL",
    "PuntenTeam2":"NULL",
    "PuntenTeam1Verl":"NULL",
    "PuntenTeam2Verl":"NULL",
    "PuntenTeam1Strafsch":"NULL",
    "PuntenTeam2Strafsch":"NULL",
    "Competitie":"W1-0255**-12-430405!",
    "District":"W1",
    "CompId":"0255",
    "ClassId":"12",
    "PouleId":"430405",
    "CompType":"R",
    "WedstrijdDag":"7",
    "Zaalveld":"Veld",
    "MatchID":"10052245",
    "WedstrijdNummer":"88118",
    "Bijzonderheden":"",
    "VeldKNVB":"veld 2",
    "VeldClub":"",
    "Kleedkamer_thuis":"",
    "Kleedkamer_uit":"",
    "Kleedkamer_official":""
},{
    "Datum":"2015-10-17",
    "Tijd":"0930",
    "Verzameltijd":"",
    "ThuisLogo":"http:\/\/bin617.website-voetbal.nl\/sites\/voetbal.nl\/files\/knvblogos\/BBFX33T.jpg",
    "ThuisClub":"Zilvermeeuwen F1",
    "ThuisClubNummer":"BBFX33T",
    "ThuisTeamId":"122557",
    "UitLogo":"http:\/\/bin617.website-voetbal.nl\/sites\/voetbal.nl\/files\/knvblogos\/BBFW673.png",
    "UitClub":"OFC F3",
    "UitClubNummer":"BBFW673",
    "UitTeamId":"123057",
    "Scheidsrechter":"",
    "HulpScheidsrechter1":"",
    "HulpScheidsrechter2":"",
    "Facility_Id":"BBGF075",
    "Facility_naam":"Sportpark Poelenburg- Z'meeuwen",
    "Facility_Stad":"ZAANDAM",
    "Facility_Postcode":"1504NW",
    "Facility_Adres":"Poelenburg 464",
    "Aantal_Fotos":"0",
    "Aantal_Videos":"0",
    "Aantal_Reacties":"",
    "Overzicht_Reacties":"",
    "PuntenTeam1":"NULL",
    "PuntenTeam2":"NULL",
    "PuntenTeam1Verl":"NULL",
    "PuntenTeam2Verl":"NULL",
    "PuntenTeam1Strafsch":"NULL",
    "PuntenTeam2Strafsch":"NULL",
    "Competitie":"W1-0275**-13-429644!",
    "District":"W1",
    "CompId":"0275",
    "ClassId":"13",
    "PouleId":"429644",
    "CompType":"R",
    "WedstrijdDag":"7",
    "Zaalveld":"Veld",
    "MatchID":"10043587",
    "WedstrijdNummer":"79460",
    "Bijzonderheden":"",
    "VeldKNVB":"veld 2",
    "VeldClub":"",
    "Kleedkamer_thuis":"",
    "Kleedkamer_uit":"",
    "Kleedkamer_official":""
}]
}

Index Vorige: 3. Wedstrijd Volgende: 4.1 Competitie listing