Kas gali juo naudotis?
Lygos, turinčios Gold planą ir įjungusios API. Norėdami jį įjungti, eikite į Administratoriaus pradžia > API > API nustatymai ir pažymėkite Įjungti JSON API. Jei trūksta bent vieno iš šių dalykų, kiekvienas šiuose straipsniuose nurodytas žiniatinklio adresas vietoj jūsų duomenų grąžins klaidą.
Kas tai yra?
API leidžia kitai svetainei, programėlei ar programai nuskaityti jūsų lygos rungtynes, rezultatus ir turnyrines lenteles tiesiai iš LeagueRepublic. Įsivaizduokite padavėją: jūsų svetainė kažko paprašo („šiandienos rungtynes, prašau“), o LeagueRepublic atneša atsakymą.
Kaip pateikti užklausą?
Apsilankote žiniatinklio adresu, lygiai taip pat, kaip atidarytumėte tinklalapį. Vietoj gražiai atrodančio puslapio gaunate paprastą tekstą formatu, vadinamu JSON. Jūsų svetainės kūrėjo kodas arba DI asistento sukurtas puslapis nuskaito tą tekstą ir paverčia jį tuo, ką sukūrėte.
Kaip atrodo JSON?
Tai etikečių ir reikšmių sąrašas, šiek tiek panašus į užpildytą formą:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Žodis prieš dvitaškį yra lauko pavadinimas (etiketė formoje). Dalis po jo yra reikšmė (tai, kas įrašyta langelyje). API specifikacijoje paaiškinta, ką reiškia kiekvienas lauko pavadinimas.
Kas yra ID?
Kiekviena LeagueRepublic lyga, sezonas, divizionas, komanda ir rungtynės turi savo numerį, vadinamą ID. Jis veikia kaip nario numeris: niekada nesikeičia ir nėra dviejų dalykų su tuo pačiu numeriu. ID įrašote į žiniatinklio adresą, kad nurodytumėte, kurio sezono ar komandos norite.
Kaip rasti savo ID?
Jūsų lygos ID rodomas puslapyje Administratoriaus pradžia > API > API nustatymai.
Jūsų sezono ID: atidarykite šį adresą naršyklėje, vietoj [MY-LEAGUE-ID] įrašę savo lygos ID. Jame išvardyti jūsų sezonai, kiekvienas su savo ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
Diviziono ir komandos ID pateikiami sąrašuose, kuriuos grąžina API. Jei naudojate vieną iš straipsnių Sukurkite…, DI asistentas juos suranda už jus.
Ar yra apribojimas?
Taip. Kiekviena lyga per minutę gali pateikti tik tam tikrą skaičių užklausų, o jį dalijasi viskas, kas naudoja jūsų lygos duomenis: jūsų svetainė, programėlės ir bet kas kita. Gerai sukurtas puslapis išsaugo tai, ką įkėlė, užuot kartojęs užklausas. Tikslus apribojimas nurodytas API specifikacijoje.
Keli žodžiai, kuriuos matysite
Road – išvykos komanda. LeagueRepublic sako „road“ ten, kur dauguma sako „away“.
Fixture (rungtynės) – rungtynės, nesvarbu, ar jos jau sužaistos, ar ne.
Fixture group (rungtynių grupė) – divizionas (pvz., „Premier Division“), taurės turnyras ar kita rungtynių grupė.
Result (rezultatas) – rungtynės, turinčios rezultatą.
null – langelis tuščias. Lyga jo neįvedė arba jis netaikomas.
true / false – taip / ne.
Kur rasti visą informaciją?
Viskas, kas tiksliai nurodyta, pavyzdžiui, visi lauko pavadinimai, apribojimas ir klaidų pranešimai, yra API specifikacijoje: