Qui pot utilitzar-la?
Les lligues amb el pla Gold que han activat l'API. Per activar-la, ves a Inici de l'administració > API > Configuració de l'API i marca Activa JSON API. Si falta una de les dues coses, totes les adreces web d'aquests articles retornen un error en lloc de les teves dades.
Què és?
L'API permet que un altre lloc web, aplicació o programa llegeixi els partits, els resultats i les taules de la teva lliga directament des de LeagueRepublic. Pensa-hi com en un cambrer: el teu lloc web demana alguna cosa («els partits d'avui, si us plau») i LeagueRepublic porta la resposta.
Com es demana?
Visites una adreça web, igual que quan obres una pàgina web. En lloc d'una pàgina de bon veure, reps text pla en un format anomenat JSON. El codi del teu desenvolupador web, o una pàgina feta per un assistent d'IA, llegeix aquest text i el converteix en el que hagis dissenyat.
Quin aspecte té el JSON?
És una llista d'etiquetes i valors, una mica com un formulari que s'ha omplert:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
La paraula abans dels dos punts és el nom del camp (l'etiqueta del formulari). El que ve després és el valor (el que s'ha escrit a la casella). L'especificació de l'API explica què significa cada nom de camp.
Què és un ID?
Cada lliga, temporada, divisió, equip i partit de LeagueRepublic té el seu propi número, anomenat ID. Funciona com un número de soci: no canvia mai i no el comparteixen dues coses. Poses els ID a l'adreça web per indicar quina temporada o equip vols.
Com trobo els meus ID?
L'ID de la teva lliga es mostra a Inici de l'administració > API > Configuració de l'API.
L'ID de la teva temporada: obre aquesta adreça al navegador, posant l'ID de la teva lliga en lloc de [MY-LEAGUE-ID]. Llista les teves temporades, cadascuna amb el seu ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
Els ID de divisions i equips apareixen a les llistes que envia l'API. Si utilitzes un dels articles Crea…, l'assistent d'IA els busca per tu.
Hi ha un límit?
Sí. Cada lliga només pot fer un cert nombre de sol·licituds per minut, compartides per tot el que utilitza les dades de la teva lliga: el teu lloc web, les aplicacions i qualsevol altra cosa. Una pàgina ben feta desa el que carrega en lloc de tornar-ho a demanar una vegada i una altra. L'especificació de l'API indica el límit exacte.
Unes quantes paraules que veuràs
Road – l'equip visitant. LeagueRepublic diu «road» allà on la majoria de la gent diu «away» (visitant).
Fixture – un partit, tant si ja s'ha jugat com si no.
Fixture group – una divisió (com la «Premier Division»), una copa o un altre grup de partits.
Result – un partit que té marcador.
null – la casella és buida. La lliga no l'ha introduït o no s'aplica.
true / false – sí / no.
On és el detall complet?
Tot el que és exacte, com ara cada nom de camp, el límit i els missatges d'error, és a l'especificació de l'API: