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.2 Programma (1507 )

Beschrijving

Met deze call kan van het dmv. teamid doorgegeven team een lijst met het wedstrijd programma 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 het programma is, 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 programmagegevens voor dat weeknummer retourneren. Een A als weeknummer levert alle beschikbare programmagegevens 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 voetbaldatacentre)

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 voetbaldatacentre vriendschappelijke wedstrijden. Beide typen vriendschappelijke competitie wedstrijden worden terug gegeven als comptype=V.

Het programma is per weeknummer per seizoen, een seizoen loopt van week nummer 26 in het ene jaar tot weeknummer 26 in het volgende jaar. Wanneer het programma van week nummer 1 word opgevraagd is dit automatisch het programma van weeknummer 1 in het tweede halfjaar van het seizoen. Wanneer het programma van weeknummer 26 word opgevraagd is dit het programma van het eerste speelweekend in het eerste halfjaar van het seizoen.

Ter illustratie van het voorgaande, bij seizoen 2012/2013:

Weeknummer 26: programma week 26 van 2012
Weeknummer 1: programma week 1 van 2013
Weeknummer A: programma vanaf huidige datum tot einde seizoen dat bekend is.

Beschikbaarheid

API: U heeft een API sleutel nodig.

Syntax

https://api.voetbaldatacentre.nl/api/teams/<teamid>/schedule?[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 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
Verzameltijd: Verzameltijd ingevoerd bij vriendschappelijke wedstrijden in HHMM formaat. Bij-niet vriendschappelijke wedstrijden leeg
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 uit-team
Bijzonderheden: Wedstrijd status (beschreven in 2.1 Uitslagen)
Scheidsrechter: Naam van de scheidsrechter
CompNummer: Competitie Nummer
CompType: Competitie Type (R, B, N of V)
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

Output

{
    "errorcode":1000,"message":"Ok",
    "List":[{
    "MatchID":"9656197",
    "WedstrijdNummer":"5384",
    "Datum":"2015-10-18",
    "Tijd":"1400",
    "Verzameltijd":"",
    "ThuisClub":"Zilvermeeuwen 1",
    "ThuisLogo":"http:\/\/bin617.website-voetbal.nl\/sites\/voetbal.nl\/files\/knvblogos\/BBFX33T.jpg",
    "ThuisTeamID":"122561",
    "UitClub":"DCG 1",
    "UitLogo":"http:\/\/bin617.website-voetbal.nl\/sites\/voetbal.nl\/files\/knvblogos\/BBCY31B.png",
    "UitTeamID":"109254",
    "Bijzonderheden":"",
    "Scheidsrechter":"Andre, P.T.J.",
    "CompNummer":"W1-0512**-12-418659!",
    "CompType":"R",
    "WedstrijdDag":"7",
    "VeldKNVB":"veld 1",
    "VeldClub":"",
    "Kleedkamer_thuis":"",
    "Kleedkamer_uit":"",
    "Kleedkamer_official":""
},{
    "MatchID":"9656363",
    "WedstrijdNummer":"5550",
    "Datum":"2015-11-01",
    "Tijd":"1400",
    "Verzameltijd":"",
    "ThuisClub":"Hoofddorp s.v. 1",
    "ThuisLogo":"http:\/\/bin617.website-voetbal.nl\/sites\/voetbal.nl\/files\/knvblogos\/BBCY17B.png",
    "ThuisTeamID":"107028",
    "UitClub":"Zilvermeeuwen 1",
    "UitLogo":"http:\/\/bin617.website-voetbal.nl\/sites\/voetbal.nl\/files\/knvblogos\/BBFX33T.jpg",
    "UitTeamID":"122561",
    "Bijzonderheden":"",
    "Scheidsrechter":"Dokkum, L.O. van",
    "CompNummer":"W1-0512**-12-418659!",
    "CompType":"R",
    "WedstrijdDag":"8",
    "VeldKNVB":"veld 1",
    "VeldClub":"",
    "Kleedkamer_thuis":"",
    "Kleedkamer_uit":"",
    "Kleedkamer_official":""
}]
}