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.1 Uitslagen (1507
)
Beschrijving
Met deze call kan van het dmv. teamid doorgegeven team een lijst met uitslagen 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 de uitslagen zijn, 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 uitslagen voor dat weeknummer retourneren. Een A ipv een weeknummer levert alle voorgaande uitslagen op.
De comptype parameter geeft aan voor welk competitie type de resultaten worden opgevraagd. Dit kunnen zijn:
- R: reguliere competitie (default)
- B: beker competitie
- N: nacompetitie
- V: vriendschappelijke competitie (KNVB of Voetbal datacentre)
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 Voetbal Datacentre vriendschappelijke wedstrijden. Beide typen vriendschappelijke competitie wedstrijden worden terug gegeven als comptype=V.
Resultaten zijn voor een weeknummer per seizoen, een seizoen loopt van week nummer 26 in het ene jaar tot weeknummer 26 in het volgende jaar. Wanneer resultaten van week nummer 1 worden opgevraagd zijn dit automatisch de resultaten van weeknummer 1 in het tweede halfjaar van het seizoen. Wanneer resultaten van weeknummer 26 worden opgevraagd zijn dit de resultaten van het eerste speelweekend in het eerste halfjaar van het seizoen.
Ter illustratie van het voorgaande, bij seizoen 2012/2013:
- Weeknummer 26: resultaten week 26 van 2012
- Weeknummer 1: resultaten week 1 van 2013
- Weeknummer A: alle resultaten van de huidige datum terug tot 1 juli.
In de parameter 'Bijzonderheden' komen (globaal) de volgende waardes voor:
- ADO: Afgelast door Organisatie
- ADB: Afgelast door Bond
- BNO: Bezoekend team niet opgekomen
- TNO: Thuisspelend team niet opgekomen
- SNO: Scheidsrechter niet opgekomen
- TAS: Terreinafkeuring door scheidsrechter
- NOB: Niet opkomen BEIDE elftallen/teams
Bovenstaande waarde worden op de site als 'AFG'(elast) genoteerd. Verder zijn er nog:
- GOB: Gestaakt wegens onvoldoende spelers uitspelend team
- GOT: Gestaakt wegens onvoldoende spelers thuisspelend team
- GVS: Geen vervangende scheidsrechter
- GWO: Gestaakt wegens ongeval
- GWT: Gestaakt wegens tuchtzaak
- GWW: Gestaakt wegens weersomstandigheden
- GWVU: Gestaakt wegens niet hervatten van de wedstrijd uitelftal/team
- GSU: Geen spelerspas(sen) uitteam
- GSB: Geen spelerspas(sen) BEIDE teams
- GST: Geen spelerspas(sen) thuisteam
- GWV: Gestaakt wegens niet hervatten van de wedstrijd thuis elftal/team
- GWVB: Gestaakt wegens niet hervatten van de wedstrijd beide elftallen/teams
Deze waardes worden op de site als 'GEST'(aakt) weergegeven.
Tenslotte zijn er nog WNO (wedstrijdformulier niet ontvangen) en WOV (wedstrijd ongeldig verklaard). Er komen af en toe waardes bij die nog niet op dit moment bekend zijn.
Beschikbaarheid
-
API: U heeft een API sleutel nodig.
-
APP: De mobiele APP
Syntax
http://api.knvbdataservice.nl/api/teams/<teamid>/results?[weeknummer=12][&comptype=R|B|N|V&]PHPSESSID=<12345>&hash=<abbccdde200394> |
Input parameters
-
PHPSESSID:
Session ID verkregen uit initialisatie
-
hash:
Hash berekend aan client side
-
teamid:
Uniek Team ID. Let op, team moet team van club zijn.
-
weeknummer:
week waarvan de uitslagen worden opgehaald (1-52, A) (optioneel)
-
comptype:
Competitie type R = Regulier, B = Beker, N = Nacompetitie, V = Vriendschappelijke Competitie
Output parameters
-
errorcode:
1000|foutcode, errorcode is altijd gezet. Een 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
-
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",
"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",
"CompType":"V",
"CompNummer":"12345",
"WedstrijdDag":"7"
}]
}