Hvem kan bruke det?
Ligaer på Gold-planen som har slått på API-et. For å slå det på går du til Admin-startside > API > API-innstillinger og krysser av for Aktiver JSON API. Hvis en av delene mangler, gir alle nettadressene i disse artiklene en feilmelding i stedet for dataene dine.
Hva er det?
API-et lar et annet nettsted, en annen app eller et annet program lese kampene, resultatene og tabellene i ligaen din direkte fra LeagueRepublic. Tenk på det som en servitør: nettstedet ditt ber om noe («dagens kamper, takk»), og LeagueRepublic kommer tilbake med svaret.
Hvordan spør du?
Du går inn på en nettadresse, akkurat som når du åpner en nettside. I stedet for en pen side får du ren tekst i et format som heter JSON. Koden til webutvikleren din, eller en side laget av en AI-assistent, leser teksten og gjør den om til det du har designet.
Hvordan ser JSON ut?
Det er en liste med etiketter og verdier, litt som et skjema som er fylt ut:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Ordet før kolonet er feltnavnet (etiketten på skjemaet). Det som står etter, er verdien (det som ble skrevet i boksen). API-spesifikasjonen forklarer hva hvert feltnavn betyr.
Hva er en ID?
Hver liga, sesong, divisjon, lag og kamp i LeagueRepublic har sitt eget nummer, som kalles en ID. Det fungerer som et medlemsnummer: det endrer seg aldri, og ingen to ting har samme nummer. Du legger ID-er inn i nettadressen for å si hvilken sesong eller hvilket lag du vil ha.
Hvordan finner jeg ID-ene mine?
Liga-ID-en din vises under Admin-startside > API > API-innstillinger.
Sesong-ID-en din: åpne denne adressen i nettleseren din, med liga-ID-en din i stedet for [MY-LEAGUE-ID]. Den viser sesongene dine, hver med sin ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
ID-er for divisjoner og lag vises i listene API-et sender tilbake. Hvis du bruker en av Lag en…-artiklene, finner AI-assistenten dem for deg.
Finnes det en grense?
Ja. Hver liga kan bare sende et visst antall forespørsler i minuttet, og dette deles av alt som bruker ligadataene dine: nettstedet ditt, apper og alt annet. En godt laget side lagrer det den har lastet inn, i stedet for å spørre igjen og igjen. API-spesifikasjonen oppgir den nøyaktige grensen.
Noen ord du vil se
Road – bortelaget. LeagueRepublic bruker «road» der de fleste sier «away» (borte).
Fixture – en kamp, enten den er spilt ennå eller ikke.
Fixture group – en divisjon (for eksempel «Premier Division»), en cup eller en annen gruppe kamper.
Result – en fixture som har en score.
null – boksen er tom. Ligaen har ikke fylt den ut, eller den gjelder ikke.
true / false – ja / nei.
Hvor finner jeg alle detaljene?
Alt det nøyaktige, som alle feltnavn, grensen og feilmeldingene, står i API-spesifikasjonen: