Pređi na glavni sadržaj

Kako API funkcioniše

Ovaj članak jednostavnim rečima objašnjava osnove LeagueRepublic API-ja. Za praćenje vam nije potrebno tehničko znanje.

Autor Pedro Maia

Ko može da ga koristi?

Lige na planu Gold koje su uključile API. Da biste ga uključili, idite na Administratorska početna strana > API > Podešavanja API-ja i označite Omogući JSON API. Ako nešto od toga nedostaje, svaka veb adresa u ovim člancima vraća grešku umesto vaših podataka.

Šta je to?

API omogućava drugoj veb lokaciji, aplikaciji ili programu da čita utakmice, rezultate i tabele vaše lige direktno iz LeagueRepublic-a. Zamislite ga kao konobara: vaša veb lokacija nešto zatraži („današnje utakmice, molim“), a LeagueRepublic donese odgovor.

Kako se postavlja zahtev?

Posetite veb adresu, isto kao kada otvarate veb stranicu. Umesto lepo uređene stranice, dobijate običan tekst u formatu koji se zove JSON. Kod vašeg veb programera, ili stranica koju je napravio AI asistent, čita taj tekst i pretvara ga u ono što ste osmislili.

Kako izgleda JSON?

To je spisak oznaka i vrednosti, pomalo kao popunjen obrazac:

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

Reč pre dvotačke je naziv polja (oznaka na obrascu). Deo posle nje je vrednost (ono što je upisano u polje). Specifikacija API-ja objašnjava šta znači svaki naziv polja.

Šta je ID?

Svaka liga, sezona, divizija, tim i utakmica u LeagueRepublic-u ima svoj broj, koji se zove ID. Funkcioniše kao članski broj: nikada se ne menja i dve stvari nikada nemaju isti. ID-ove stavljate u veb adresu da biste naveli koju sezonu ili koji tim želite.

Kako da pronađem svoje ID-ove?

ID vaše lige prikazan je na Administratorska početna strana > API > Podešavanja API-ja.

ID vaše sezone: otvorite ovu adresu u pregledaču, sa ID-om vaše lige umesto [MOJ-ID-LIGE]. Ona prikazuje vaše sezone, svaku sa njenim ID-om.

https://api.leaguerepublic.com/json/getSeasonsForLeague/[MOJ-ID-LIGE].json

ID-ovi divizija i timova pojavljuju se u listama koje API vraća. Ako koristite neki od članaka Napravite…, AI asistent ih pronalazi umesto vas.

Postoji li ograničenje?

Da. Svaka liga može da pošalje samo određen broj zahteva u minutu, a taj broj dele sve stvari koje koriste podatke vaše lige: vaša veb lokacija, aplikacije i sve ostalo. Dobro napravljena stranica čuva ono što učita umesto da iznova i iznova traži. Specifikacija API-ja navodi tačno ograničenje.

Nekoliko reči koje ćete videti

Road – gostujući tim. LeagueRepublic kaže „road“ tamo gde većina ljudi kaže „u gostima“.

Utakmica (fixture) – meč, bez obzira na to da li je već odigran ili ne.

Grupa utakmica (fixture group) – divizija (na primer „Premier Division“), kup ili druga grupa utakmica.

Rezultat (result) – utakmica koja ima rezultat.

null – polje je prazno. Liga ga nije unela ili se ne odnosi na taj slučaj.

true / false – da / ne.

Gde su svi detalji?

Sve precizne informacije, kao što su svi nazivi polja, ograničenje i poruke o greškama, nalaze se u specifikaciji API-ja:

Da li je ovo odgovor na vaše pitanje?