Qui peut l'utiliser ?
Les ligues ayant le plan Gold et qui ont activé l'API. Pour l'activer, allez dans Accueil admin > API > Paramètres de l'API (Admin Home > API > API Settings) et cochez Activer l'API JSON (Enable JSON API). Si l'un des deux manque, toutes les adresses web de ces articles renvoient une erreur au lieu de vos données.
De quoi s'agit-il ?
L'API permet à un autre site web, une application ou un programme de lire les calendriers, les résultats et les classements de votre ligue directement depuis LeagueRepublic. Pensez à un serveur de restaurant : votre site web demande quelque chose (« les matchs d'aujourd'hui, s'il vous plaît ») et LeagueRepublic rapporte la réponse.
Comment faire une demande ?
Vous visitez une adresse web, comme pour ouvrir une page web. Au lieu d'une page agréable à regarder, vous recevez du texte brut dans un format appelé JSON. Le code de votre développeur web, ou une page créée par un assistant IA, lit ce texte et le transforme en ce que vous avez conçu.
À quoi ressemble le JSON ?
C'est une liste d'étiquettes et de valeurs, un peu comme un formulaire rempli :
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Le mot avant les deux-points est le nom du champ (l'étiquette du formulaire). Ce qui suit est la valeur (ce qui a été écrit dans la case). La spécification de l'API explique la signification de chaque nom de champ.
Qu'est-ce qu'un identifiant (ID) ?
Chaque ligue, saison, division, équipe et match dans LeagueRepublic possède son propre numéro, appelé identifiant (ID). Il fonctionne comme un numéro de membre : il ne change jamais et deux éléments ne partagent jamais le même. Vous placez les identifiants dans l'adresse web pour indiquer la saison ou l'équipe voulue.
Comment trouver mes identifiants ?
L'identifiant de votre ligue s'affiche dans Accueil admin > API > Paramètres de l'API (Admin Home > API > API Settings).
L'identifiant de votre saison : ouvrez cette adresse dans votre navigateur, en remplaçant [MY-LEAGUE-ID] par l'identifiant de votre ligue. Elle liste vos saisons, chacune avec son identifiant.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
Les identifiants des divisions et des équipes figurent dans les listes renvoyées par l'API. Si vous utilisez l'un des articles Créer…, l'assistant IA les recherche pour vous.
Y a-t-il une limite ?
Oui. Chaque ligue ne peut effectuer qu'un certain nombre de requêtes par minute, partagées par tout ce qui utilise les données de votre ligue : votre site web, des applications et tout le reste. Une page bien conçue enregistre ce qu'elle charge au lieu de redemander sans cesse. La spécification de l'API donne la limite exacte.
Quelques mots que vous verrez
Road – l'équipe visiteuse. LeagueRepublic dit « road » là où la plupart des gens disent « à l'extérieur ».
Fixture – un match, qu'il ait déjà été joué ou non.
Fixture group – une division (comme « Division d'honneur »), une coupe ou un autre groupe de matchs.
Result – un match qui a un score.
null – la case est vide. La ligue ne l'a pas renseignée ou elle ne s'applique pas.
true / false – oui / non.
Où trouver tous les détails ?
Tout ce qui est précis, comme chaque nom de champ, la limite et les messages d'erreur, se trouve dans la spécification de l'API :