Tko ga može koristiti?
Lige s planom Gold 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 jedno od toga, svaka web adresa u ovim člancima vraća pogrešku umjesto vaših podataka.
Što je to?
API omogućuje drugoj web stranici, aplikaciji ili programu da čitaju utakmice, rezultate i ljestvice vaše lige izravno iz LeagueRepublica. Zamislite ga kao konobara: vaša web stranica nešto traži ("današnje utakmice, molim"), a LeagueRepublic donosi odgovor.
Kako se traži?
Posjetite web adresu, baš kao kad otvarate web stranicu. Umjesto lijepo uređene stranice dobivate 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 ste osmislili.
Kako izgleda JSON?
To je popis oznaka i vrijednosti, pomalo poput ispunjenog obrasca:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Riječ prije dvotočke je naziv polja (oznaka na obrascu). Ono što dolazi iza nje je vrijednost (ono što je upisano u polje). Specifikacija API-ja objašnjava što znači svaki naziv polja.
Što je ID?
Svaka liga, sezona, divizija, momčad i utakmica u LeagueRepublicu ima svoj broj koji se zove ID. Radi poput članskog broja: nikad se ne mijenja i dvije stvari nikad ne dijele isti. ID-ove upisujete u web adresu kako biste rekli koju sezonu ili momčad želite.
Kako pronaći 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, s ID-om svoje lige umjesto [MY-LEAGUE-ID]. Prikazuje popis vaših sezona, svaku s njezinim ID-om.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
ID-ovi divizija i momčadi nalaze se na popisima koje API vraća. Ako koristite neki od članaka Izradite…, AI asistent ih pronalazi umjesto vas.
Postoji li ograničenje?
Da. Svaka liga može slati samo određeni broj zahtjeva u minuti, a taj se broj dijeli među svime što koristi podatke vaše lige: vašom web stranicom, aplikacijama i svime ostalim. Dobro napravljena stranica sprema ono što učita umjesto da iznova i iznova traži isto. Točno ograničenje navedeno je u specifikaciji API-ja.
Nekoliko riječi koje ćete vidjeti
Road – gostujuća momčad. LeagueRepublic kaže "road" tamo gdje većina ljudi kaže "away" (gostujuća).
Fixture – utakmica, bez obzira je li već odigrana ili nije.
Fixture group – divizija (npr. "Premier Division"), kup ili neka druga skupina utakmica.
Result – utakmica koja ima rezultat.
null – polje je prazno. Liga ga nije unijela ili se ne odnosi na ovaj slučaj.
true / false – da / ne.
Gdje su sve pojedinosti?
Sve točne pojedinosti, poput svakog naziva polja, ograničenja i poruka o pogreškama, nalaze se u specifikaciji API-ja: