Kuka voi käyttää sitä?
Liigat, joilla on Gold-tilaus ja jotka ovat ottaneet API:n käyttöön. Voit ottaa sen käyttöön siirtymällä kohtaan Hallinnan etusivu > API > API-asetukset (Admin Home > API > API Settings) ja valitsemalla Ota JSON API käyttöön (Enable JSON API). 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 otteluohjelmat, tulokset ja sarjataulukot suoraan LeagueRepublicista. Ajattele sitä tarjoilijana: sivustosi pyytää jotain (”päivän ottelut, kiitos”) ja LeagueRepublic tuo vastauksen.
Miten pyyntö tehdään?
Avaat verkko-osoitteen aivan kuten verkkosivun. Nätin sivun sijaan saat takaisin pelkkää tekstiä JSON-nimisessä muodossa. Verkkokehittäjäsi koodi tai tekoälyavustajan tekemä sivu lukee tämän tekstin ja muuttaa sen suunnittelemaksesi näkymäksi.
Miltä JSON näyttää?
Se on luettelo nimiöistä ja arvoista, vähän kuin täytetty lomake:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Kaksoispistettä edeltävä sana on kentän nimi (lomakkeen nimiö). Sen jälkeen tuleva osa on arvo (se, mitä ruutuun kirjoitettiin). API-määrittelyssä kerrotaan, 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 liitetään verkko-osoitteeseen, jotta kerrotaan, mitä kautta tai joukkuetta haluat.
Miten löydän ID:ni?
Liigasi ID näkyy kohdassa Hallinnan etusivu > API > API-asetukset (Admin Home > API > API Settings).
Kautesi ID: avaa tämä osoite selaimessasi ja korvaa [MY-LEAGUE-ID] liigasi ID:llä. Osoite luettelee kautesi ja kunkin kauden ID:n.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
Divisioonien ja joukkueiden ID:t näkyvät API:n palauttamissa luetteloissa. Jos käytät jotakin Luo…-artikkelia, tekoälyavustaja hakee ne puolestasi.
Onko rajoitusta?
On. Jokainen liiga voi tehdä vain tietyn määrän pyyntöjä minuutissa, ja raja jaetaan kaiken kesken, mikä käyttää liigasi tietoja: verkkosivustosi, sovellukset ja kaikki muu. Hyvin tehty sivu tallentaa lataamansa tiedot sen sijaan, että pyytäisi niitä yhä uudelleen. API-määrittelyssä on tarkka raja.
Muutama sana, joita näet
Road – vierasjoukkue. LeagueRepublic sanoo ”road” siellä, missä useimmat sanovat ”vieras”.
Fixture – ottelu riippumatta siitä, onko se jo pelattu vai ei.
Fixture group – divisioona (esimerkiksi ”Premier Division”), cup tai jokin muu otteluiden ryhmä.
Result – ottelu, jolla on tulos.
null – ruutu on tyhjä. Liiga ei syöttänyt sitä tai se ei koske tätä ottelua.
true / false – kyllä / ei.
Mistä löydän kaikki yksityiskohdat?
Kaikki tarkka tieto, kuten jokainen kentän nimi, raja ja virheilmoitukset, on API-määrittelyssä: