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.

2.3 Stand (1507 )

Beschrijving

Met deze call kan van het dmv. teamid doorgegeven team een lijst stand in de competitie van dit team worden opgehaald. De parameter comptype is optioneel. De default is 'R'; soms doet een team niet mee aan een reguliere competitie, dan wordt de default successievelijk B en N. In de return parameter CompType wordt meegegeven voor welk competitie type de uitslagen zijn, dit is handig als geen comptype aan de call wordt meegegeven (eg. laat API het zelf maar uitzoeken). periode is ook optioneel, de default is de huidige stand. Wanneer een periode (1-4) wordt meegegeven zal de API de stand van die periode retourneren.

De parameter poule is optioneel. Als deze niet wordt meegegeven, worden alle standen teruggegeven. Om de stand van een specifieke poule op te vragen, dient het PouleId meegegeven te worden. Dit PouleId kunt u vinden bij competities. Door middel van pouleid=all krijgt u de standen van alle competities terug.
Wij raden aan, om zowel bij de najaars- als de voorjaarscompetitie altijd het poule-id mee te geven.

LET OP: de stand kan niet per weeknummer worden berekend.

Beschikbaarheid

Syntax

http://api.knvbdataservice.nl/api/teams/<teamid>/ranking?[comptype=R|B|N|V&][periode=S|1|2|3|4|A&][pouleid=all|123456&]PHPSESSID=<12345>&hash=<abbccdde200394>

Input parameters

Output parameters

Voorbeelden

stub: http://api.knvbdataservice.nl/stub/teams/1234/ranking
api: http://api.knvbdataservice.nl/api/teams/1234/ranking

Output

{
    "errorcode":1000,"message":"Ok",
    "List":[{
    "naam":"Abcoude D3",
    "TeamID":"12345",
    "logo":"http:\/\/abcoude.nl\/logo.png",
    "Positie":"1",
    "Gespeeld":"0",
    "Gewonnen":"0",
    "Gelijk":"0",
    "Verloren":"0",
    "Punten":"0",
    "DoelpuntenVoor":"0",
    "DoelpuntenTegen":"0",
    "PuntenMindering":"0",
    "CompType":"R",
    "CompNummer":"12345",
    "WedstrijdDag":"7",
    "Periode":"S"
},{
    "naam":"Buitenveldert D3",
    "logo":"http:\/\/buitenveldert.nl\/logo.png",
    "Positie":"2",
    "Gespeeld":"0",
    "Gewonnen":"0",
    "Gelijk":"0",
    "Verloren":"0",
    "Punten":"0",
    "DoelpuntenVoor":"0",
    "DoelpuntenTegen":"0",
    "PuntenMindering":"1",
    "CompType":"R",
    "CompNummer":"12345",
    "WedstrijdDag":"7",
    "Periode":"S"
}]
}