Mine põhisisu juurde

Kuidas API töötab

See artikkel selgitab LeagueRepublicu API põhitõdesid lihtsas keeles. Selle järgimiseks 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, annab 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 ettekandjast: teie veebisait küsib midagi („tänased mängud, palun”) ja LeagueRepublic toob vastuse.

Kuidas küsida?

Külastate veebiaadressi, täpselt nagu veebilehe avamisel. Kena välimusega lehe asemel saate tagasi lihtteksti vormingus nimega JSON. Teie veebiarendaja kood või tehisintellekti assistendi tehtud leht loeb selle teksti ja muudab selle selleks, mille olete kavandanud.

Milline JSON välja näeb?

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

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

Koolonile eelnev sõna on välja nimi (vormi silt). See, mis tuleb pärast seda, on väärtus (see, mis lahtrisse kirjutati). API spetsifikatsioon selgitab, mida iga välja nimi tähendab.

Mis on ID?

Igal LeagueRepublicu liigal, hooajal, divisjonil, võistkonnal ja mängul on oma number, mida nimetatakse ID-ks. See toimib nagu liikmenumber: see ei muutu kunagi ja kaks asja ei jaga sama numbrit. Lisate ID-d 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 [MY-LEAGUE-ID] oma liiga ID-ga. See loetleb teie hooajad koos nende ID-dega.

https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json

Divisjonide ja võistkondade ID-d on loendites, mida API tagastab. Kui kasutate mõnda artiklit Looge…, 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”, kus enamik ütleb „away” (võõrsil).

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

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

Result – mäng, millel on skoor.

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?