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 eno od obojega manjka, vsi spletni naslovi v teh člankih namesto tvojih podatkov vrnejo napako.
Kaj je to?
API omogoča drugemu spletnemu mestu, aplikaciji ali programu, da neposredno iz LeagueRepublic prebere razporede tekem, rezultate in lestvice tvoje lige. Predstavljaj si ga kot natakarja: tvoje spletno mesto nekaj naroči („današnje tekme, prosim“), LeagueRepublic pa prinese odgovor.
Kako povprašaš?
Obiščeš spletni naslov, tako kot odpreš spletno stran. Namesto lepo oblikovane strani dobiš navadno besedilo v obliki, ki ji pravimo JSON. Koda tvojega spletnega razvijalca ali stran, ki jo je naredil pomočnik z umetno inteligenco, to besedilo prebere in ga spremeni v karkoli, kar oblikuješ.
Kako izgleda JSON?
To je seznam oznak in vrednosti, nekako kot izpolnjen obrazec:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Beseda pred dvopičjem je ime polja (oznaka na obrazcu). Tisto za njo je vrednost (kar je bilo vpisano v polje). Specifikacija API-ja 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 dve stvari je ne delita. ID-je vneseš 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 namesto [MY-LEAGUE-ID] vpiši ID svoje lige. Našteje tvoje sezone, vsako z njenim ID-jem.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
ID-ji divizij in ekip se pojavijo na seznamih, ki jih pošlje API. Če uporabljaš enega od člankov Ustvari …, pomočnik z umetno inteligenco te ID-je poišče namesto tebe.
Ali obstaja omejitev?
Da. Vsaka liga lahko pošlje le določeno število zahtev na minuto, ki si jih delijo vse aplikacije, ki uporabljajo podatke tvoje lige: tvoje spletno mesto, aplikacije in vse drugo. Dobro narejena stran shrani, kar naloži, namesto da znova in znova zahteva isto. Natančna omejitev je navedena v specifikaciji API-ja.
Nekaj besed, ki jih boš videl
Road – gostujoča ekipa. LeagueRepublic uporablja „road“, kjer večina ljudi reče „away“.
Fixture – tekma, ne glede na to, ali je že odigrana ali ne.
Fixture group – divizija (na primer „Premier Division“), pokal ali druga skupina tekem.
Result – tekma, ki ima rezultat.
null – polje je prazno. Liga ga ni vnesla ali pa se ne nanaša na to tekmo.
true / false – da / ne.
Kje najdem vse podrobnosti?
Vse natančne informacije, na primer vsa imena polj, omejitev in sporočila o napakah, so v specifikaciji API-ja: