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.

4 Competities (1507 )

Beschrijving

Met deze call kan extra informatie worden verkregen omtrent competities waarin een team speelt. Door de parameter comptype leeg te laten wordt als output informatie over alle competities waarin een team speelt verkregen.

Wanneer echter comptype wordt gezet, dan wordt alleen informatie terug gegeven over dat type competitie. Uit de 'teams' call kan al informatie worden verkregen of een team:

In een reguliere competitie(s) speelt
In een bekercompetitie(s) speelt
In een nacompetitie(s) speelt

Deze informatie word echter alleen in "J"|"N" terug gegeven en geeft een snel overzicht of de teams al dan niet in een reguliere, beker of nacompetitie spelen. Wanneer we van een team weten mbv. de /teams/ call dat ze bijvoorbeeld in een bekercompetitie spelen kunnen we de /competities/ call als volgt gebruiken:

/competities/6543?comptype='B'

Teneinde meer informatie omtrent deze competitie te verkrijgen.

Beschikbaarheid

API: U heeft een API sleutel nodig.
APP: De mobiele APP

Syntax

http://api.knvbdataservice.nl/api/competities/<teamid>?[comptype=R|B|N&]PHPSESSID=<12345>&hash=<abbccdde200394>

Input parameters

comptype: Competitie Type (R = regular, B = Beker, N = Nacompetitie)
PHPSESSID: Session ID verkregen uit initialisatie
hash: Hash berekend aan client side

Output parameters

CompName: Competitie Naam
ClassName: Naam van de klasse
PouleName: Naam van de poule
District: District
CompId: Competitie ID
ClassId: Class ID
PouleId: Poule ID
CompType: CompType

Voorbeelden

stub: http://api.knvbdataservice.nl/stub/competities

api: http://api.knvbdataservice.nl/api/competities

Output

{
    "errorcode":1000,"message":"Ok",
    "List":[{
    "CompName":"Mannen Zondag standaard",
    "District":"W1",
    "CompId":"0512",
    "ClassId":"14",
    "PouleId":"298933"
}]
}