Qui peut l'utiliser ?
Les ligues du plan Gold qui ont activé l'API. Pour l'activer, allez dans Accueil Admin > API > Paramètres de l'API et cochez Activer l'API JSON. S'il manque l'un ou l'autre, chaque adresse Web de ces articles renvoie une erreur au lieu de vos données.
Qu'est-ce que c'est ?
L'API permet à un autre site Web, à une application ou à un programme de lire les matchs, les résultats et les classements de votre ligue directement depuis LeagueRepublic. Voyez-la comme un serveur dans un 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 ouvrez une adresse Web, exactement comme une page Web. Au lieu d'une jolie page, 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 selon le design que vous voulez.
À 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 ID ?
Chaque ligue, saison, division, équipe et match dans LeagueRepublic a son propre numéro, appelé ID. Il fonctionne comme un numéro de membre : il ne change jamais et deux éléments ne peuvent pas avoir le même. Vous mettez les ID dans l'adresse Web pour indiquer quelle saison ou quelle équipe vous voulez.
Comment trouver mes ID ?
L'ID de votre ligue est affiché dans Accueil Admin > API > Paramètres de l'API.
L'ID de votre saison : ouvrez cette adresse dans votre navigateur, en remplaçant [ID-DE-MA-LIGUE] par l'ID de votre ligue. Elle liste vos saisons, chacune avec son ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[ID-DE-MA-LIGUE].json
Les ID des divisions et des équipes figurent dans les listes que renvoie l'API. Si vous utilisez l'un des articles Créer…, l'assistant IA les trouve pour vous.
Y a-t-il une limite ?
Oui. Chaque ligue ne peut faire qu'un certain nombre de requêtes par minute, partagé entre tout ce qui utilise les données de votre ligue : votre site Web, vos applications et tout le reste. Une page bien conçue garde en mémoire ce qu'elle charge au lieu de redemander sans cesse. La spécification de l'API indique la limite exacte.
Quelques mots que vous verrez
Road – l'équipe à l'extérieur. LeagueRepublic dit "road" là où la plupart des gens disent « extérieur » (« away » en anglais).
Fixture – un match, qu'il ait déjà été joué ou non.
Fixture group – une division (comme « Division Élite »), 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 remplie, 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 :