Pređi na glavni sadržaj

Kako funkcioniše API

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

Autor Pedro Maia

Ko ga može koristiti?

Lige sa planom 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 bilo šta od toga nedostaje, sve veb adrese u ovim člancima vraćaju grešku umesto vaših podataka.

Šta je to?

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

Kako se postavlja zahtev?

Posetite veb adresu, kao kad otvarate veb stranicu. Umesto lepo izgledajuće stranice dobijate običan tekst u formatu koji se zove JSON. Kôd vašeg veb programera ili stranica koju je napravio AI asistent čita taj tekst i pretvara ga u ono što vi dizajnirate.

Kako izgleda JSON?

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

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

Reč pre dvotačke je naziv polja (oznaka na obrascu). Ono što dolazi 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. Radi kao broj članske karte: nikad se ne menja i dve stvari ne dele isti broj. ID-ove stavljate u veb adresu da biste naznačili koju sezonu ili 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 [MY-LEAGUE-ID]. Ona navodi vaše sezone, svaku sa njenim ID-om.

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

ID-ovi divizija i timova pojavljuju se u listama koje API šalje. Ako koristite jedan od članaka Napravite…, AI asistent ih pronalazi umesto vas.

Postoji li ograničenje?

Da. Svaka liga može da pošalje samo određeni broj zahteva u minuti, a taj broj dele sve aplikacije 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 isto. Tačno ograničenje navedeno je u specifikaciji API-ja.

Nekoliko reči koje ćete videti

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

Fixture – utakmica, bez obzira na to da li je već odigrana ili nije.

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

Result – utakmica koja ima rezultat.

null – polje je prazno. Liga ga nije unela ili se ne odnosi na tu utakmicu.

true / false – da / ne.

Gde se nalaze svi detalji?

Sve tačne informacije, kao što su svaki naziv polja, ograničenje i poruke o grešci, nalaze se u specifikaciji API-ja:

Da li je ovo odgovor na vaše pitanje?