Kdo ho může používat?
Ligy s plánem Gold, které mají zapnuté API. Chcete-li ho zapnout, přejděte do Domovská stránka správce > API > Nastavení API a zaškrtněte Povolit JSON API. Pokud cokoli z toho chybí, každá webová adresa v těchto článcích vrátí místo vašich dat chybu.
Co to je?
API umožňuje jinému webu, aplikaci nebo programu číst zápasy, výsledky a tabulky vaší ligy přímo z LeagueRepublic. Představte si číšníka: váš web si o něco řekne („dnešní zápasy, prosím“) a LeagueRepublic přinese odpověď.
Jak se ptát?
Navštívíte webovou adresu, stejně jako když otevíráte webovou stránku. Místo pěkně vypadající stránky ale dostanete prostý text ve formátu zvaném JSON. Kód vašeho webového vývojáře nebo stránka vytvořená AI asistentem tento text přečte a promění ho v cokoli, co si navrhnete.
Jak vypadá JSON?
Je to seznam popisků a hodnot, trochu jako vyplněný formulář:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Slovo před dvojtečkou je název pole (popisek ve formuláři). To, co následuje za ní, je hodnota (to, co bylo napsáno do políčka). Význam každého názvu pole vysvětluje specifikace API.
Co je ID?
Každá liga, sezóna, divize, tým a zápas v LeagueRepublic má své vlastní číslo, kterému se říká ID. Funguje jako číslo člena: nikdy se nemění a žádné dvě věci ho nesdílejí. ID vkládáte do webové adresy, abyste určili, kterou sezónu nebo který tým chcete.
Jak zjistím svá ID?
Vaše ID ligy se zobrazuje v části Domovská stránka správce > API > Nastavení API.
Vaše ID sezóny: otevřete tuto adresu v prohlížeči a místo [MY-LEAGUE-ID] vložte své ID ligy. Zobrazí seznam vašich sezón, každou s jejím ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
ID divizí a týmů najdete v seznamech, které API vrací. Pokud použijete některý z článků Vytvořte…, AI asistent je za vás dohledá.
Existuje limit?
Ano. Každá liga může odeslat jen určitý počet požadavků za minutu, který sdílí vše, co používá data vaší ligy: váš web, aplikace i cokoli dalšího. Dobře vytvořená stránka si načtená data ukládá, místo aby se ptala pořád dokola. Přesný limit uvádí specifikace API.
Pár slov, se kterými se setkáte
Road – hostující tým. LeagueRepublic říká „road“ tam, kde většina lidí říká „away“.
Fixture – zápas, ať už se již hrál, nebo ne.
Fixture group – divize (například „Premier Division“), pohár nebo jiná skupina zápasů.
Result – zápas, který má skóre.
null – políčko je prázdné. Liga ho nezadala, nebo se netýká daného případu.
true / false – ano / ne.
Kde najdu všechny podrobnosti?
Vše přesné, například každý název pole, limit a chybová hlášení, najdete ve specifikaci API: