Kuka voi käyttää sitä?
Liigat, joilla on ”Gold”-suunnitelma ja jotka ovat ottaneet API:n käyttöön. Ota se käyttöön kohdassa Ylläpidon etusivu > API > API-asetukset ja valitse Ota JSON API käyttöön. Jos jompikumpi puuttuu, jokainen näiden artikkelien verkko-osoite palauttaa virheen tietojesi sijaan.
Mikä se on?
API:n avulla toinen verkkosivusto, sovellus tai ohjelma voi lukea liigasi ottelut, tulokset ja sarjataulukot suoraan LeagueRepublicista. Ajattele sitä tarjoilijana: verkkosivustosi pyytää jotain (”tämän päivän ottelut, kiitos”), ja LeagueRepublic tuo vastauksen.
Miten pyyntö tehdään?
Avaat verkko-osoitteen, aivan kuin avaisit verkkosivun. Hienon sivun sijaan saat takaisin pelkkää tekstiä JSON-nimisessä muodossa. Verkkokehittäjäsi koodi tai tekoälyavustajan tekemä sivu lukee tekstin ja muuttaa sen sellaiseksi kuin suunnittelet.
Miltä JSON näyttää?
Se on luettelo nimikkeitä ja arvoja, vähän kuin täytetty lomake:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Kaksoispistettä edeltävä sana on kentän nimi (lomakkeen nimike). Sen jälkeinen osa on arvo (mitä ruutuun kirjoitettiin). API-määrittely kertoo, mitä kukin kentän nimi tarkoittaa.
Mikä on ID?
Jokaisella LeagueRepublicin liigalla, kaudella, divisioonalla, joukkueella ja ottelulla on oma numeronsa, jota kutsutaan ID:ksi. Se toimii kuin jäsennumero: se ei koskaan muutu, eikä kahdella asialla ole samaa. ID:t lisätään verkko-osoitteeseen, jotta voit kertoa, minkä kauden tai joukkueen haluat.
Miten löydän ID:ni?
Liigasi ID näkyy kohdassa Ylläpidon etusivu > API > API-asetukset.
Kautesi ID: avaa tämä osoite selaimessa ja korvaa [LIIGANI-ID] liigasi ID:llä. Se listaa kautesi ja niiden ID:t.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[LIIGANI-ID].json
Divisioonien ja joukkueiden ID:t näkyvät luetteloissa, jotka API palauttaa. Jos käytät jotakin Luo…-artikkelia, tekoälyavustaja hakee ne puolestasi.
Onko rajoitusta?
Kyllä. Kukin liiga voi tehdä vain tietyn määrän pyyntöjä minuutissa, ja määrä jaetaan kaiken liigasi tietoja käyttävän kesken: verkkosivustosi, sovellusten ja kaiken muun. Hyvin tehty sivu tallentaa lataamansa tiedot eikä kysy niitä yhä uudelleen. API-määrittely kertoo tarkan rajan.
Muutama sana, joita näet
Road – vierasjoukkue. LeagueRepublic käyttää sanaa "road", kun useimmat sanovat ”vieras” (”away”).
Fixture – ottelu, on se pelattu tai ei.
Fixture group – divisioona (kuten ”Valioliiga”), cup tai muu otteluryhmä.
Result – ottelu, jolla on tulos.
null – ruutu on tyhjä. Liiga ei täyttänyt sitä, tai se ei koske tapausta.
true / false – kyllä / ei.
Mistä löydän kaikki yksityiskohdat?
Kaikki tarkat tiedot, kuten jokainen kentän nimi, raja ja virheilmoitukset, ovat API-määrittelyssä: