Tko ga može koristiti?
Lige s planom 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 pogrešku umjesto vaših podataka.
Što je to?
API omogućuje drugoj web stranici, aplikaciji ili programu da čita utakmice, rezultate i ljestvice vaše lige izravno iz LeagueRepublica. Zamislite ga kao konobara: vaša web stranica nešto zatraži ("današnje utakmice, molim"), a LeagueRepublic donese odgovor.
Kako se šalje zahtjev?
Otvorite web adresu, baš kao kad otvarate web stranicu. Umjesto lijepo uređene stranice dobivate običan tekst u formatu koji se zove JSON. Kod vašeg web programera ili stranica koju je izradio 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). Dio 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 vlastiti broj koji se zove ID. Funkcionira kao članski broj: nikad se ne mijenja i ne mogu ga dijeliti dvije stvari. 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 administratora > API > Postavke API-ja.
ID vaše sezone: otvorite ovu adresu u pregledniku, s ID-om svoje lige umjesto [ID-MOJE-LIGE]. Ona navodi vaše sezone, svaku s njezinim ID-om.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[ID-MOJE-LIGE].json
ID-ovi divizija i momčadi pojavljuju se na popisima koje API vraća. Ako koristite neki od članaka Izradite…, AI asistent će ih potražiti umjesto vas.
Postoji li ograničenje?
Da. Svaka liga može poslati samo određen broj zahtjeva u minuti, a taj broj dijeli sve što koristi podatke vaše lige: vaša web stranica, aplikacije i sve ostalo. Dobro izrađena stranica sprema ono što učita umjesto da to traži iznova i iznova. Specifikacija API-ja navodi točno ograničenje.
Nekoliko riječi koje ćete vidjeti
Road – gostujuća momčad. LeagueRepublic kaže "road" ondje gdje većina ljudi kaže "away" (u gostima).
Utakmica (fixture) – susret, bez obzira je li već odigran ili nije.
Skupina utakmica (fixture group) – divizija (npr. "Premier Division"), kup ili neka druga skupina utakmica.
Rezultat – utakmica koja ima rezultat.
null – polje je prazno. Liga ga nije unijela ili se ne odnosi na tu stavku.
true / false – da / ne.
Gdje su svi detalji?
Sve točne pojedinosti, poput svakog naziva polja, ograničenja i poruka o pogreškama, nalaze se u specifikaciji API-ja: