Wie kan hem gebruiken?
Leagues met het Gold-plan die de API hebben ingeschakeld. Om hem in te schakelen, ga je naar Admin-startpagina > API > API-instellingen en vink je JSON API inschakelen aan. Als een van beide ontbreekt, geeft elk webadres in deze artikelen een foutmelding in plaats van je gegevens.
Wat is het?
Met de API kan een andere website, app of programma de wedstrijden, uitslagen en standen van je league rechtstreeks uit LeagueRepublic lezen. Zie het als een ober: je website vraagt om iets ("de wedstrijden van vandaag, graag") en LeagueRepublic brengt het antwoord.
Hoe vraag je erom?
Je bezoekt een webadres, net zoals wanneer je een webpagina opent. In plaats van een mooie pagina krijg je platte tekst terug in een formaat dat JSON heet. De code van je webontwikkelaar, of een pagina die een AI-assistent heeft gemaakt, leest die tekst en maakt er het ontwerp van dat jij wilt.
Hoe ziet JSON eruit?
Het is een lijst met labels en waarden, een beetje zoals een ingevuld formulier:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Het woord vóór de dubbele punt is de veldnaam (het label op het formulier). Het deel erna is de waarde (wat er in het vakje is ingevuld). De API-specificatie legt uit wat elke veldnaam betekent.
Wat is een ID?
Elke league, elk seizoen, elke divisie, elk team en elke wedstrijd in LeagueRepublic heeft een eigen nummer, een ID. Het werkt als een lidmaatschapsnummer: het verandert nooit en geen twee dingen hebben hetzelfde nummer. Je zet ID's in het webadres om aan te geven welk seizoen of team je wilt.
Hoe vind ik mijn ID's?
Je league-ID staat op Admin-startpagina > API > API-instellingen.
Je seizoens-ID: open dit adres in je browser, met je league-ID in plaats van [MIJN-LEAGUE-ID]. Je ziet dan je seizoenen, elk met een eigen ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MIJN-LEAGUE-ID].json
Divisie- en team-ID's staan in de lijsten die de API terugstuurt. Als je een van de …maken-artikelen gebruikt, zoekt de AI-assistent ze voor je op.
Is er een limiet?
Ja. Elke league kan maar een bepaald aantal verzoeken per minuut doen, gedeeld door alles wat de gegevens van je league gebruikt: je website, apps en al het andere. Een goed gemaakte pagina bewaart wat ze laadt in plaats van steeds opnieuw te vragen. De API-specificatie noemt de exacte limiet.
Een paar woorden die je tegenkomt
Road – het uitspelende team. LeagueRepublic zegt "road" waar de meeste mensen "away" (uit) zeggen.
Wedstrijd (fixture) – een wedstrijd, of die nu al gespeeld is of niet.
Wedstrijdgroep (fixture group) – een divisie (zoals "Premier Division"), een beker of een andere groep wedstrijden.
Uitslag (result) – een wedstrijd met een score.
null – het vakje is leeg. De league heeft het niet ingevuld, of het is niet van toepassing.
true / false – ja / nee.
Waar vind ik alle details?
Alles wat exact is, zoals elke veldnaam, de limiet en de foutmeldingen, staat in de API-specificatie: