Ko ga može koristiti?
Lige na planu Gold koje su uključile API. Da biste ga uključili, idite na Početna stranica administratora > API > Postavke API-ja i označite Omogući JSON API. Ako nešto od toga nedostaje, svaka web adresa u ovim člancima vraća grešku umjesto vaših podataka.
Šta je to?
API omogućava drugoj web stranici, aplikaciji ili programu da čita utakmice, rezultate i tabele vaše lige direktno iz LeagueRepublic-a. Zamislite ga kao konobara: vaša web stranica nešto zatraži ("današnje utakmice, molim"), a LeagueRepublic donese odgovor.
Kako se traže podaci?
Posjetite web adresu, baš kao kad otvarate web stranicu. Umjesto lijepo uređene stranice, dobijete običan tekst u formatu koji se zove JSON. Kôd vašeg web programera, ili stranica koju je napravio AI asistent, čita taj tekst i pretvara ga u ono što vi osmislite.
Kako izgleda JSON?
To je lista oznaka i vrijednosti, pomalo kao popunjen obrazac:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Riječ prije dvotačke je naziv polja (oznaka na obrascu). Dio iza nje je vrijednost (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 članski broj: nikad se ne mijenja i nikoje dvije stvari nemaju isti. ID-ove stavljate u web adresu da kažete koju sezonu ili koji tim želite.
Kako da pronađem svoje ID-ove?
ID vaše lige prikazan je na Početna stranica administratora > API > Postavke API-ja.
ID vaše sezone: otvorite ovu adresu u pregledniku, s ID-om vaše lige umjesto [ID-MOJE-LIGE]. Prikazat će listu vaših sezona, svaku s njenim ID-om.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[ID-MOJE-LIGE].json
ID-ovi divizija i timova nalaze se u listama koje API vraća. Ako koristite neki od članaka Napravite…, AI asistent će ih pronaći umjesto vas.
Postoji li ograničenje?
Da. Svaka liga može poslati samo određeni broj zahtjeva u minuti, a dijeli ih sve što koristi podatke vaše lige: vaša web stranica, aplikacije i bilo šta drugo. Dobro napravljena stranica sačuva ono što učita umjesto da pita iznova i iznova. Tačno ograničenje navedeno je u specifikaciji API-ja.
Nekoliko riječi koje ćete vidjeti
Road – gostujući tim. LeagueRepublic kaže "road" tamo gdje većina ljudi kaže "u gostima".
Fixture – utakmica, bez obzira na to da li je već odigrana ili nije.
Fixture group – divizija (npr. "Premier Division"), kup ili neka druga grupa utakmica.
Result – utakmica koja ima rezultat.
null – polje je prazno. Liga ga nije popunila ili se ne odnosi na taj slučaj.
true / false – da / ne.
Gdje su svi detalji?
Svi tačni podaci, kao što su svaki naziv polja, ograničenje i poruke o greškama, nalaze se u specifikaciji API-ja: