Mine põhisisu juurde

Kuidas API töötab

See artikkel selgitab lihtsas keeles LeagueRepublicu API põhitõdesid. Selle mõistmiseks pole vaja tehnilisi teadmisi.

Autorilt Pedro Maia

Kes saavad seda kasutada?

Liigad, kellel on „Gold”-plaan ja kes on API sisse lülitanud. Selle sisselülitamiseks minge Administraatori avaleht > API > API seaded ja märkige Luba JSON API. Kui kumbki puudub, tagastab iga selle artikli veebiaadress teie andmete asemel vea.

Mis see on?

API võimaldab teisel veebisaidil, rakendusel või programmil lugeda teie liiga mänge, tulemusi ja tabeleid otse LeagueRepublicust. Mõelge sellest kui kelnerist: teie veebisait küsib midagi („tänased mängud, palun”) ja LeagueRepublic toob vastuse.

Kuidas päringut teha?

Te avate veebiaadressi täpselt nagu tavalise veebilehe. Kena lehe asemel saate tagasi lihtteksti JSON-nimelises vormingus. Teie veebiarendaja kood või tehisintellekti assistendi tehtud leht loeb selle teksti ja muudab selle selliseks, nagu te kujundate.

Milline JSON välja näeb?

See on siltide ja väärtuste loend, natuke nagu täidetud ankeet:

{ "homeTeamName": "Arthurlie", "homeScore": "2" }

Koolonile eelnev sõna on välja nimi (silt ankeedil). Sellele järgnev osa on väärtus (see, mis lahtrisse kirjutati). API spetsifikatsioon selgitab iga välja nime tähendust.

Mis on ID?

Igal liigal, hooajal, divisjonil, võistkonnal ja mängul on LeagueRepublicus oma number, mida nimetatakse ID-ks. See toimib nagu liikmenumber: see ei muutu kunagi ja kahel asjal ei ole sama numbrit. ID-d lisatakse veebiaadressi, et öelda, millist hooaega või võistkonda soovite.

Kuidas oma ID-sid leida?

Teie liiga ID on näha lehel Administraatori avaleht > API > API seaded.

Teie hooaja ID: avage see aadress oma brauseris, asendades [MINU-LIIGA-ID] oma liiga ID-ga. See loetleb teie hooajad koos nende ID-dega.

https://api.leaguerepublic.com/json/getSeasonsForLeague/[MINU-LIIGA-ID].json

Divisjonide ja võistkondade ID-d on loendites, mida API tagastab. Kui kasutate mõnda Looge… artiklit, otsib tehisintellekti assistent need teie eest üles.

Kas on piirang?

Jah. Iga liiga saab teha minutis ainult teatud arvu päringuid ja seda jagavad kõik, mis kasutavad teie liiga andmeid: teie veebisait, rakendused ja kõik muu. Hästi tehtud leht salvestab laaditud andmed, selle asemel et neid ikka ja jälle küsida. API spetsifikatsioon annab täpse piirangu.

Mõned sõnad, mida näete

Road – võõrsil mängiv võistkond. LeagueRepublic ütleb "road" seal, kus enamik ütleb „võõrsil” („away”).

Fixture – mäng, olenemata sellest, kas see on juba mängitud või mitte.

Fixture group – divisjon (näiteks „Meistriliiga”), karikas või muu mängude rühm.

Result – mäng, millel on tulemus.

null – lahter on tühi. Liiga ei sisestanud seda või see ei kehti.

true / false – jah / ei.

Kust leida kõik üksikasjad?

Kõik täpne, näiteks iga välja nimi, piirang ja veateated, on API spetsifikatsioonis:

Kas see vastas teie küsimusele?