Hvem kan bruge den?
Ligaer på Gold-planen, som har slået API'en til. For at slå den til skal du gå til Admin-startside > API > API-indstillinger og sætte flueben ved Aktivér JSON API. Hvis en af delene mangler, returnerer alle webadresser i disse artikler en fejl i stedet for dine data.
Hvad er det?
API'en lader en anden hjemmeside, app eller et andet program læse din ligas kampe, resultater og stillinger direkte fra LeagueRepublic. Tænk på den som en tjener: din hjemmeside beder om noget ("dagens kampe, tak"), og LeagueRepublic kommer tilbage med svaret.
Hvordan spørger man?
Du besøger en webadresse, ligesom når du åbner en webside. I stedet for en flot side får du almindelig tekst tilbage i et format, der hedder JSON. Din webudviklers kode, eller en side lavet af en AI-assistent, læser teksten og gør den til det, du designer.
Hvordan ser JSON ud?
Det er en liste med betegnelser og værdier, lidt ligesom en udfyldt formular:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Ordet før kolonet er feltnavnet (betegnelsen på formularen). Delen efter er værdien (det, der er skrevet i feltet). API-specifikationen forklarer, hvad hvert feltnavn betyder.
Hvad er et ID?
Hver liga, sæson, division, hvert hold og hver kamp i LeagueRepublic har sit eget nummer, som kaldes et ID. Det fungerer som et medlemsnummer: det ændrer sig aldrig, og to ting har aldrig det samme. Du sætter ID'er ind i webadressen for at sige, hvilken sæson eller hvilket hold du vil have.
Hvordan finder jeg mine ID'er?
Dit liga-ID vises under Admin-startside > API > API-indstillinger.
Dit sæson-ID: åbn denne adresse i din browser med dit liga-ID i stedet for [MIT-LIGA-ID]. Den viser dine sæsoner, hver med sit ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MIT-LIGA-ID].json
ID'er for divisioner og hold står i de lister, API'en sender tilbage. Hvis du bruger en af artiklerne Byg en…, slår AI-assistenten dem op for dig.
Er der en grænse?
Ja. Hver liga kan kun sende et bestemt antal forespørgsler i minuttet, og de deles af alt, der bruger din ligas data: din hjemmeside, apps og alt andet. En veludført side gemmer det, den henter, i stedet for at spørge igen og igen. API-specifikationen angiver den præcise grænse.
Et par ord, du vil støde på
Road – udeholdet. LeagueRepublic siger "road", hvor de fleste siger "ude".
Fixture – en kamp, uanset om den er spillet endnu eller ej.
Fixture group – en division (f.eks. "Premier Division"), en pokalturnering eller en anden gruppe kampe.
Result – en kamp, der har et resultat.
null – feltet er tomt. Ligaen har ikke udfyldt det, eller det er ikke relevant.
true / false – ja / nej.
Hvor finder jeg alle detaljerne?
Alt det præcise, f.eks. hvert feltnavn, grænsen og fejlmeddelelserne, står i API-specifikationen: