Qui la pot fer servir?
Les lligues amb el pla Gold que tenen l'API activada. Per activar-la, ves a Inici d'administració > API > Configuració de l'API i marca Activa l'API JSON. Si falta alguna d'aquestes 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 classificacions de la teva lliga directament de LeagueRepublic. Imagina-la com un cambrer: el teu lloc web demana alguna cosa ("els partits d'avui, si us plau") i LeagueRepublic hi porta la resposta.
Com es demanen les dades?
Visites una adreça web, igual que quan obres una pàgina web. En lloc d'una pàgina ben dissenyada, 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 tu dissenyis.
Com és el JSON?
És una llista d'etiquetes i valors, una mica com un formulari omplert:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
La paraula abans dels dos punts és el nom del camp (l'etiqueta del formulari). El que hi ha després és el valor (el que s'ha escrit a la casella). L'especificació de l'API explica què vol dir 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 hi ha dues coses que el comparteixin. Poses els ID a l'adreça web per indicar quina temporada o quin equip vols.
Com trobo els meus ID?
L'ID de la teva lliga es mostra a Inici d'administració > API > Configuració de l'API.
L'ID de la teva temporada: obre aquesta adreça al navegador, amb l'ID de la teva lliga en lloc de [EL-MEU-ID-DE-LLIGA]. Hi trobaràs la llista de les teves temporades, cadascuna amb el seu ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[EL-MEU-ID-DE-LLIGA].json
Els ID de divisions i equips apareixen a les llistes que retorna l'API. Si fas servir un dels articles Crea…, l'assistent d'IA els busca per tu.
Hi ha cap límit?
Sí. Cada lliga només pot fer un nombre determinat de peticions per minut, compartides entre tot el que fa servir 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 demanar-ho una vegada i una altra. L'especificació de l'API indica el límit exacte.
Algunes paraules que veuràs
Road – l'equip visitant. LeagueRepublic diu "road" on la majoria de la gent diu "fora".
Fixture – un partit, tant si ja s'ha jugat com si no.
Fixture group – una divisió (com ara "Premier Division"), una copa o un altre grup de partits.
Result – un partit que té resultat.
null – la casella és buida. La lliga no l'ha omplert o no s'hi aplica.
true / false – sí / no.
On hi ha tots els detalls?
Tots els detalls exactes, com ara cada nom de camp, el límit i els missatges d'error, són a l'especificació de l'API: