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.

Beschrijving

Met deze call kan het programma van een competitie opgehaald worden. De parameters District,CompId,ClassId,PouleId zijn verplicht. Deze gegevens zijn te vinden in 4.1 competities.

Beschikbaarheid

API: U heeft een API sleutel nodig.

APP: De mobiele APP

Syntax

http://api.knvbdataservice.nl/api/competities/<TeamId>/<District>/<CompId>/<ClassId>/<PouleId>/schedule?[weeknummer=12&]PHPSESSID=<12345>&hash=<abbccdde200394>

Input parameters

TeamId: TeamId van het team dat in deze competitie speelt.

District: District verkregen uit 4.1 competities

CompId: Competitie ID verkregen uit 4.1 competities

ClassId: Class ID verkregen uit 4.1 competities

PouleId: Poule ID verkregen uit 4.1 competities

PHPSESSID: Session ID verkregen uit initialisatie

hash: Hash berekend aan client side

weeknummer: Van welke week het programma opgehaald moet worden (optioneel)

Output parameters

MatchID: Uniek ID van de wedstrijd

WedstrijdNummer: Nummer van de wedstrijd dat door de KNVB gebruikt wordt op het wedstrijdformulier

Datum: Speeldatum van de wedstrijd

Tijd: Begin tijd van de wedstrijd

ThuisClub: Naam van team bestaande uit Club TeamAanduiding

ThuisLogo: URL van logo van thuisclub

ThuisTeamID: TeamId van het thuisteam

UitClub: Naam van team bestaande uit Club TeamAanduiding

UitLogo: URL van logo van uitclub

UitTeamID: TeamId van het uitteam

Bijzonderheden: Wedstrijd status (beschreven in 2.1 Uitslagen)

Scheidsrechter: Naam van de scheidsrechter

Facility_Id: Id vam de facility

Facility_naam: Naam van de facility

Facility_Stad: Stad van de facility

Facility_Postcode: Postcode van de facility

Facility_Adres: Adres van de facility

CompType: Competitie type

WedstrijdDag: Wedstrijddag

VeldKNVB: Naam van het veld bij de KNVB

VeldClub: Naam van het veld bij de club

Kleedkamer_thuis: Kleedkamer voor het thuisteam

Kleedkamer_uit: Kleedkamer voor het uitteam

Kleedkamer_official: Kleedkamer voor de scheidsrechter

Voorbeelden

Output

{
    "errorcode":1000,"message":"Ok",
    "List":[{
    "MatchID":"6709198",
    "Datum":"2014-09-11",
    "Tijd":"0945",
    "ThuisClub":"Forza Almere D1",
    "ThuisLogo":"http:\/\/forza-almere.nl\/logo.png",
    "ThuisTeamID":"12345",
    "UitClub":"Buitenveldert D3",
    "UitLogo":"http:\/\/buitenveldert.nl\/logo.png",
    "UitTeamID":"67890",
    "Bijzonderheden":"",
    "Scheidsrechter":"Tjong A Hung, M.S.",
    "Facility_Id":"BBDB71H",
    "Facility_naam":"Sportpark Jan van Galen",
    "Facility_Stad":"AMSTERDAM",
    "Facility_Postcode":"1061MA",
    "Facility_Adres":"Laan van Spartaan 1",
    "CompType":"R",
    "WedstrijdDag":"7",
    "VeldKNVB":"veld 1",
    "VeldClub":"",
    "Kleedkamer_thuis":"",
    "Kleedkamer_uit":"",
    "Kleedkamer_official":""
},{
    "MatchID":"6709198",
    "Datum":"2014-09-11",
    "Tijd":"1000",
    "ThuisClub":"Forza Almere D2",
    "ThuisLogo":"http:\/\/forza-almere.nl\/logo.png",
    "ThuisTeamID":"12345",
    "UitClub":"Buitenveldert D3",
    "UitLogo":"http:\/\/buitenveldert.nl\/logo.png",
    "UitTeamID":"67890",
    "Bijzonderheden":"",
    "Scheidsrechter":"Tjong A Hung, M.S.",
    "Facility_Id":"BBDB71H",
    "Facility_naam":"Sportpark Jan van Galen",
    "Facility_Stad":"AMSTERDAM",
    "Facility_Postcode":"1061MA",
    "Facility_Adres":"Laan van Spartaan 1",
    "CompType":"R",
    "WedstrijdDag":"7",
    "VeldKNVB":"veld 1",
    "VeldClub":"",
    "Kleedkamer_thuis":"",
    "Kleedkamer_uit":"",
    "Kleedkamer_official":""
}]
}