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 skiltyje Administratoriaus pradžia > API > API nustatymai.
Jūsų sezono ID: atidarykite šį adresą naršyklėje, vietoj [MANO-LYGOS-ID] įrašę savo lygos ID. Bus pateiktas jūsų sezonų sąrašas, kiekvienas su savo ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MANO-LYGOS-ID].json
Divizionų ir komandų ID pateikiami API grąžinamuose sąrašuose. Jei naudojate vieną iš straipsnių Sukurkite…, DI asistentas juos suras už jus.
Ar yra apribojimas?
Taip. Kiekviena lyga per minutę gali pateikti tik tam tikrą užklausų skaičių, kurį dalijasi viskas, kas naudoja jūsų lygos duomenis: jūsų svetainė, programėlės ir visa kita. Gerai sukurtas puslapis išsaugo tai, ką įkėlė, užuot prašęs vėl ir vėl. Tikslus apribojimas nurodytas API specifikacijoje.
Keli žodžiai, kuriuos pamatysite
Road – svečių komanda. LeagueRepublic sako „road“ ten, kur dauguma žmonių sako „away“ (išvykoje).
Rungtynės (fixture) – susitikimas, nesvarbu, ar jis jau sužaistas, ar dar ne.
Rungtynių grupė (fixture group) – divizionas (pvz., „Premier Division“), taurė ar kita rungtynių grupė.
Rezultatas – rungtynės, kuriose jau yra įvestas rezultatas.
null – langelis tuščias. Lyga jo neužpildė arba jis netaikomas.
true / false – taip / ne.
Kur rasti visą informaciją?
Visa tiksli informacija, pavyzdžiui, kiekvienas lauko pavadinimas, apribojimas ir klaidų pranešimai, pateikta API specifikacijoje: