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 app eller et program lese ligaens kamper, resultater og tabeller rett fra LeagueRepublic. Tenk på det som en servitør: nettstedet ditt ber om noe («dagens kamper, takk»), og LeagueRepublic kommer med svaret.
Hvordan spør du?
Du går til en nettadresse, akkurat som når du åpner en nettside. I stedet for en pen side får du tilbake 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 utfylt skjema:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Ordet før kolonet er feltnavnet (etiketten på skjemaet). Delen etter er verdien (det som står i feltet). API-spesifikasjonen forklarer hva hvert feltnavn betyr.
Hva er en ID?
Hver liga, sesong, divisjon, hvert lag og hver kamp i LeagueRepublic har sitt eget nummer, kalt en ID. Det fungerer som et medlemsnummer: det endres aldri, og ingen to ting har det samme. Du setter 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, med liga-ID-en din i stedet for [MIN-LIGA-ID]. Den viser sesongene dine, hver med sin ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MIN-LIGA-ID].json
Divisjons- og lag-ID-er står i listene API-et sender tilbake. Hvis du bruker en av Lag en…-artiklene, slår AI-assistenten dem opp for deg.
Finnes det en grense?
Ja. Hver liga kan bare sende et visst antall forespørsler i minuttet, og de deles mellom alt som bruker ligaens data: nettstedet, apper og alt annet. En godt laget side lagrer det den henter, i stedet for å spørre igjen og igjen. API-spesifikasjonen oppgir den nøyaktige grensen.
Noen ord du vil se
Road – bortelaget. LeagueRepublic sier «road» der de fleste sier «away» (borte).
Kamp (fixture) – en kamp, enten den er spilt eller ikke.
Kampgruppe (fixture group) – en divisjon (for eksempel «Premier Division»), en cup eller en annen gruppe kamper.
Resultat (result) – en kamp som har et resultat.
null – feltet er tomt. Ligaen har ikke fylt det ut, eller det gjelder ikke.
true / false – ja / nei.
Hvor finner jeg alle detaljene?
Alt det nøyaktige, som hvert feltnavn, grensen og feilmeldingene, står i API-spesifikasjonen: