Ko ga može koristiti?
Lige s Gold planom koje su uključile API. Da biste ga uključili, idite na Početna stranica administracije > API > Postavke API-ja i označite Omogući JSON API. Ako nedostaje bilo šta od toga, 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 traži nešto („današnje utakmice, molim“), a LeagueRepublic donosi odgovor.
Kako se traži?
Posjetite web adresu, baš kao kad otvarate web stranicu. Umjesto lijepo izgledajuće stranice dobijate 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 šta god ste osmislili.
Kako izgleda JSON?
To je lista oznaka i vrijednosti, pomalo kao popunjen obrazac:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Riječ ispred dvotačke je naziv polja (oznaka na obrascu). Ono poslije nje je vrijednost (ono što je upisano u okvir). 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: nikada se ne mijenja i dvije stvari ga ne dijele. ID-ove stavljate u web adresu da biste rekli koju sezonu ili tim želite.
Kako da pronađem svoje ID-ove?
ID vaše lige prikazan je na Početna stranica administracije > API > Postavke API-ja.
ID vaše sezone: otvorite ovu adresu u pregledniku, stavljajući ID svoje lige umjesto [MY-LEAGUE-ID]. Ona navodi vaše sezone, svaku s njenim ID-om.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
ID-ovi divizija i timova pojavljuju se na listama koje API šalje. Ako koristite jedan od članaka Izrada…, AI asistent ih traži umjesto vas.
Postoji li ograničenje?
Da. Svaka liga može slati samo određeni broj zahtjeva u minuti, koji dijele sve stvari koje koriste podatke vaše lige: vaša web stranica, aplikacije i bilo šta drugo. Dobro napravljena stranica sprema ono što učita umjesto da traži 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 „away“ (gost).
Fixture – utakmica, bez obzira na to je li već odigrana ili nije.
Fixture group – divizija (kao što je „Premier Division“), kup ili druga grupa utakmica.
Result – utakmica koja ima rezultat.
null – okvir je prazan. Liga ga nije unijela ili se ne odnosi na ovaj slučaj.
true / false – da / ne.
Gdje su svi detalji?
Sve tačne informacije, kao što su svaki naziv polja, ograničenje i poruke o greškama, nalaze se u specifikaciji API-ja: