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 worden alle uitslagen van de competitie opgehaald. De parameters District,CompId,ClassId,PouleId zijn verplicht. Deze gegevens zijn te vinden in 4.1 competities. weeknummer is optioneel, de default is de huidige week. Wanneer een weeknummer (1-52, A) word meegegeven zal de API de uitslagen voor dat weeknummer retourneren. Wanneer de A wordt meegegeven levert de aanroep alle bekende uitslagen op.

Beschikbaarheid

API: U heeft een API sleutel nodig.

APP: De mobiele APP

Syntax

http://api.knvbdataservice.nl/api/competities/<TeamId>/<District>/<CompId>/<ClassId>/<PouleId>/results?[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 de uitslagen weergegeven moeten worden (optioneel)

Output parameters

errorcode: 1000|foutcode, errorcode is altijd gezet meet errorcode 1000 betekent dat alles goed is gegaan

message: Als er een fout opgetreden is staat hierin een uitleg van de fout

List: lijst met wedstrijd resultaten bestaande uit:

MatchID: Uniek ID van de wedstrijd

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

Datum: Datum van wedstrijd in YYYY-MM-DD formaat

Tijd: Tijd van wedstrijd in HHMM formaat

ThuisClub: Naam van team bestaande uit Club TeamAanduiding

ThuisLogo: URL van logo van thuisclub

ThuisTeamID: Uniek ID van thuis team

UitClub: Naam van team bestaande uit Club TeamAanduiding

UitLogo: URL van logo van uitclub

UitTeamID: Uniek ID van het uit-team

PuntenTeam1: # doelpunten thuis club

PuntenTeam2: # doelpunten uit club

PuntenTeam1Verl: # doelpunten thuis club in verlenging, geeft NULL als er niet is gescoord of er geen verlenging is geweest

PuntenTeam2Verl: # doelpunten uit club in verlenging, geeft NULL als er niet is gescoord of er geen verlenging is geweest

PuntenTeam1Strafsch: # doelpunten thuis club bij strafschoppen, geeft NULL als er niet is gescoord of er geen strafschoppen genomen zijn

PuntenTeam2Strafsch: # doelpunten thuis club bij strafschoppen, geeft NULL als er niet is gescoord of er geen strafschoppen genomen zijn

Bijzonderheden: Wedstrijd status (beschreven in 2.1 Uitslagen)

Scheidsrechter: Naam van de scheidsrechter

CompType: Competitie Type (R, B, N of V)

CompNummer: Competitie Nummer

WedstrijdDag: Wedstrijddag

Voorbeelden

Output

{
    "errorcode":1000,"message":"Ok",
    "List":[{
    "MatchID":"189338",
    "Datum":"2014-09-11",
    "Tijd":"0945",
    "ThuisClub":"Forza Almere D1",
    "ThuisLogo":"http:\/\/forza-almere\/logo.png",
    "ThuisTeamID":"12345",
    "UitClub":"Buitenveldert D3",
    "UitLogo":"http:\/\/buitenveldert.nl\/logo.png",
    "UitTeamID":"67890",
    "PuntenTeam1":"-",
    "PuntenTeam2":"-",
    "PuntenTeam1Verl":"NULL",
    "PuntenTeam2Verl":"NULL",
    "PuntenTeam1Strafsch":"NULL",
    "PuntenTeam2Strafsch":"NULL",
    "Bijzonderheden":"Afgelast",
    "Official_id":"123",
    "Official_naam":"A. Scheidsrechter",
    "CompType":"R",
    "CompNummer":"12345",
    "WedstrijdDag":"7"
},{
    "MatchID":"12",
    "Datum":"2014-09-11",
    "Tijd":"1000",
    "ThuisClub":"Forza Almere D2",
    "ThuisLogo":"http:\/\/forza-almere\/logo.png",
    "UitClub":"Buitenboys D3",
    "UitLogo":"http:\/\/buitenveldert.nl\/logo.png",
    "PuntenTeam1":"4",
    "PuntenTeam2":"1",
    "PuntenTeam1Verl":"NULL",
    "PuntenTeam2Verl":"NULL",
    "PuntenTeam1Strafsch":"NULL",
    "PuntenTeam2Strafsch":"NULL",
    "Official_id":"123",
    "Official_naam":"A. Scheidsrechter",
    "CompType":"V",
    "CompNummer":"12345",
    "WedstrijdDag":"7"
}]
}