Vem kan använda det?
Ligor med planen Gold som har slagit på API:et. För att slå på det går du till Admin-startsida > API > API-inställningar och kryssar i Aktivera JSON API. Om något av detta saknas returnerar varje webbadress 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 ligans 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 frågar man?
Du besöker en webbadress, precis som när du öppnar en webbsida. I stället för en snygg sida får du tillbaka ren text i ett format som heter JSON. Din webbutvecklares kod, eller en sida som en AI-assistent har gjort, läser texten och gör om den till det du har designat.
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 på 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 ett eget nummer, som kallas ID. Det fungerar som ett medlemsnummer: det ändras aldrig och två saker har aldrig samma. Du lägger in ID:n i webbadressen för att ange vilken säsong eller vilket lag du vill ha.
Hur hittar jag mina ID:n?
Ditt lig-ID visas under Admin-startsida > API > API-inställningar.
Ditt säsongs-ID: öppna den här adressen i webbläsaren, med ditt lig-ID i stället för [MITT-LIG-ID]. Den listar dina säsonger, var och en med sitt ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MITT-LIG-ID].json
Divisions- och lag-ID:n finns i listorna som API:et skickar tillbaka. Om du använder någon av Skapa en…-artiklarna slår AI-assistenten upp dem åt dig.
Finns det en gräns?
Ja. Varje liga kan bara göra ett visst antal förfrågningar per minut, och de delas av allt som använder ligans data: din webbplats, appar och allt annat. En välgjord sida sparar det den har laddat i stället för att fråga om och om igen. API-specifikationen anger den exakta gränsen.
Några ord du kommer att se
Road – bortalaget. LeagueRepublic säger "road" där de flesta säger "borta".
Match (fixture) – en match, oavsett om den har spelats ännu eller inte.
Matchgrupp (fixture group) – en division (till exempel "Premier Division"), en cup eller en annan grupp av matcher.
Resultat (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: