Vem kan använda det?
Ligor med planen Gold som har aktiverat API:et. Gå till Admin-startsida > API > API-inställningar för att aktivera det och bocka i Aktivera JSON API. Om något av detta saknas ger alla webbadresser i de här artiklarna ett felmeddelande i stället för dina data.
Vad är det?
Med API:et kan en annan webbplats, app eller ett annat program läsa din ligas matcher, resultat och tabeller direkt från LeagueRepublic. Tänk på det som en servitör: din webbplats ber om något (”dagens matcher, tack”) och LeagueRepublic kommer tillbaka med svaret.
Hur ber man om data?
Du går till en webbadress, precis som när du öppnar en webbsida. I stället för en snygg sida får du tillbaka vanlig text i ett format som kallas JSON. Din webbutvecklares kod, eller en sida som en AI-assistent har gjort, läser texten och gör om den till vad du än designar.
Hur ser JSON ut?
Det är en lista med etiketter och värden, ungefär som ett ifyllt formulär:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Ordet före kolonet är fältnamnet (etiketten i formuläret). Det som kommer efter är värdet (det som skrevs i rutan). API-specifikationen förklarar vad varje fältnamn betyder.
Vad är ett ID?
Varje liga, säsong, division, lag och match i LeagueRepublic har sitt eget nummer, ett så kallat ID. Det fungerar som ett medlemsnummer: det ändras aldrig och inga två saker delar på samma. Du lägger in ID:n i webbadressen för att tala om vilken säsong eller vilket lag du vill ha.
Hur hittar jag mina ID:n?
Ditt liga-ID visas under Admin-startsida > API > API-inställningar.
Ditt säsongs-ID: öppna den här adressen i webbläsaren, med ditt liga-ID i stället för [MY-LEAGUE-ID]. Den listar dina säsonger, var och en med sitt ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
ID:n för divisioner och lag finns i listorna som API:et skickar tillbaka. Om du använder någon av artiklarna Bygg en…, slår AI-assistenten upp dem åt dig.
Finns det en gräns?
Ja. Varje liga kan bara göra ett visst antal anrop per minut, och det delas av allt som använder din ligas data: din webbplats, appar och allt annat. En välgjord sida sparar det den har hämtat i stället för att fråga om och om igen. Den exakta gränsen står i API-specifikationen.
Några ord som du kommer att se
Road – bortalaget. LeagueRepublic säger ”road” där de flesta säger ”away”.
Fixture – en match, oavsett om den har spelats ännu eller inte.
Fixture group – en division (till exempel ”Premier Division”), en cup eller en annan grupp av matcher.
Result – en match som har ett resultat.
null – rutan är tom. Ligan har inte fyllt i den, eller så gäller den inte.
true / false – ja / nej.
Var finns alla detaljer?
Allt exakt, som varje fältnamn, gränsen och felmeddelandena, finns i API-specifikationen: