Kdo ho může používat?
Ligy s plánem Gold, které mají API zapnuté. Zapnete ho v Domovská stránka správce > API > Nastavení API zaškrtnutím Povolit JSON API. Pokud jedno z toho chybí, každá webová adresa v těchto článcích místo vašich dat vrátí 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 ho jako číšníka: váš web si o něco řekne („dnešní zápasy, prosím“) a LeagueRepublic přinese odpověď.
Jak se na data zeptat?
Navštívíte webovou adresu, stejně jako když otevíráte webovou stránku. Místo hezky vypadající stránky ale dostanete obyčejný text ve formátu, kterému se říká 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 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). Část za ní je hodnota (to, co bylo do políčka napsáno). Specifikace API vysvětluje, co který název pole znamená.
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 členské číslo: nikdy se nemění a žádné dvě věci nemají stejné. ID vkládáte do webové adresy, abyste řekli, kterou sezónu nebo který tým chcete.
Jak najdu svá ID?
ID vaší ligy najdete v Domovská stránka správce > API > Nastavení API.
ID vaší sezóny: otevřete v prohlížeči tuto adresu a místo [ID-MOJÍ-LIGY] do ní vložte ID své ligy. Zobrazí se seznam vašich sezón, každá se svým ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[ID-MOJÍ-LIGY].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 vyhledá za vás.
Existuje nějaký limit?
Ano. Každá liga může za minutu poslat jen určitý počet požadavků a o ten se dělí vše, co data vaší ligy používá: váš web, aplikace a cokoli dalšího. Dobře udělaná stránka si načtená data uloží, místo aby se ptala znovu a znovu. Přesný limit uvádí specifikace API.
Několik slov, na která narazíte
Road – hostující tým. LeagueRepublic říká "road" tam, kde většina lidí řekne „venku“.
Fixture – zápas, ať už byl odehrán, 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 nevyplnila, nebo se netýká.
true / false – ano / ne.
Kde najdu všechny podrobnosti?
Všechny přesné údaje, například každý název pole, limit a chybové zprávy, najdete ve specifikaci API: