Kdo ga lahko uporablja?
Lige z načrtom Gold, ki so vklopile API. Če ga želiš vklopiti, pojdi na Skrbniška domača stran > API > Nastavitve API in označi Omogoči JSON API. Če kar koli od tega manjka, vsak spletni naslov v teh člankih namesto tvojih podatkov vrne napako.
Kaj je to?
API omogoča drugemu spletnemu mestu, aplikaciji ali programu, da tekme, rezultate in lestvice tvoje lige bere neposredno iz LeagueRepublic. Predstavljaj si ga kot natakarja: tvoje spletno mesto nekaj naroči (»današnje tekme, prosim«), LeagueRepublic pa prinese odgovor.
Kako vprašaš?
Obiščeš spletni naslov, tako kot ko odpreš spletno stran. Namesto lepo oblikovane strani dobiš navadno besedilo v obliki, ki se imenuje JSON. Koda tvojega spletnega razvijalca ali stran, ki jo je izdelal pomočnik AI, to besedilo prebere in ga spremeni v to, kar si oblikuješ.
Kako je videti JSON?
To je seznam oznak in vrednosti, nekoliko podoben izpolnjenemu obrazcu:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Beseda pred dvopičjem je ime polja (oznaka na obrazcu). Del za njim je vrednost (kar je vpisano v polje). Specifikacija API pojasni, kaj pomeni vsako ime polja.
Kaj je ID?
Vsaka liga, sezona, divizija, ekipa in tekma v LeagueRepublic ima svojo številko, imenovano ID. Deluje kot članska številka: nikoli se ne spremeni in nobeni dve stvari je nimata enake. ID-je vpišeš v spletni naslov, da poveš, katero sezono ali ekipo želiš.
Kako najdem svoje ID-je?
ID tvoje lige je prikazan na Skrbniška domača stran > API > Nastavitve API.
ID tvoje sezone: odpri ta naslov v brskalniku, pri čemer [ID-MOJE-LIGE] zamenjaj z ID-jem svoje lige. Prikaže seznam tvojih sezon, vsako z njenim ID-jem.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[ID-MOJE-LIGE].json
ID-ji divizij in ekip so v seznamih, ki jih vrne API. Če uporabiš enega od člankov Izdelaj …, jih pomočnik AI poišče namesto tebe.
Ali obstaja omejitev?
Da. Vsaka liga lahko pošlje le določeno število zahtev na minuto, ki si jih delijo vsi, ki uporabljajo podatke tvoje lige: tvoje spletno mesto, aplikacije in vse drugo. Dobro narejena stran shrani, kar naloži, namesto da sprašuje znova in znova. Natančno omejitev navaja specifikacija API.
Nekaj besed, ki jih boš videl
Road – gostujoča ekipa. LeagueRepublic uporablja besedo »road« tam, kjer večina ljudi reče »away« (v gosteh).
Tekma (fixture) – tekma, ne glede na to, ali je že odigrana ali ne.
Skupina tekem (fixture group) – divizija (na primer »Premier Division«), pokal ali druga skupina tekem.
Rezultat (result) – tekma, ki ima izid.
null – polje je prazno. Liga ga ni izpolnila ali pa ne velja.
true / false – da / ne.
Kje so vse podrobnosti?
Vse natančne informacije, kot so imena vseh polj, omejitev in sporočila o napakah, so v specifikaciji API: