L'API LeagueRepublic permet à votre propre site web, application ou programme de lire les saisons, calendriers, résultats, classements, équipes et statistiques de votre ligue, directement depuis LeagueRepublic. Elle est en lecture seule : rien dans votre ligue ne peut être modifié par son intermédiaire.
Ce dont vous avez besoin
Le plan Gold. L'API fait partie de l'abonnement Gold.
L'API activée. Allez dans Accueil admin > API > Paramètres de l'API (Admin Home > API > API Settings) et cochez Activer l'API JSON (Enable JSON API). Vous pouvez la désactiver à tout moment.
Quelqu'un pour construire avec. Un développeur web, ou un assistant IA comme ChatGPT ou Claude. Les articles Créer… ci-dessous vous donnent des instructions toutes prêtes à coller dans un assistant IA.
Étape 1 : activer l'API
Dans l'administration de votre ligue, allez dans Accueil admin > API > Paramètres de l'API (Admin Home > API > API Settings) et cochez Activer l'API JSON (Enable JSON API). La même page affiche l'identifiant de votre ligue, dont vous aurez besoin à l'étape suivante.
Étape 2 : trouver vos identifiants
Chaque saison, division et équipe possède son propre numéro d'identifiant. Vous les utilisez pour indiquer les données voulues. Comment fonctionne l'API explique les identifiants et comment trouver les vôtres.
Étape 3 : choisir comment construire
Avec un assistant IA : choisissez l'article correspondant à ce que vous voulez construire et suivez-le.
Avec un développeur : essayez sans ligue à vous. Ces adresses utilisent la ligue de démonstration de LeagueRepublic, vous pouvez donc voir de vraies réponses tout de suite :
Saisons :
Divisions et coupes : https://api.leaguerepublic.com/json/getFixtureGroupsForSeason/153020000.json
Équipes d'une division : https://api.leaguerepublic.com/json/getTeamsForFixtureGroup/1/985736993.json
Tous les matchs de la saison : https://api.leaguerepublic.com/json/getFixturesForSeason/153020000.json
Les matchs d'une équipe : https://api.leaguerepublic.com/json/getFixturesForTeam/153020000/154033156.json
Le hub des matchs :
Les statistiques d'une équipe : https://api.leaguerepublic.com/json/getStatisticSummaryForTeam/153020000/154033156.json
envoyez-leur la spécification de l'API. Elle liste tous les services, champs, limites et messages d'erreur.
Il existe aussi une version en texte brut de la même spécification pour les outils d'IA :
Bon à savoir
Il existe une limite au nombre de requêtes que votre ligue peut effectuer chaque minute. Elle est partagée par tout ce qui utilise les données de votre ligue. Les pages doivent enregistrer ce qu'elles chargent plutôt que de redemander sans cesse. La spécification donne les détails.
Seuls les résultats approuvés sont affichés, sauf dans le hub des matchs, qui affiche aussi les résultats en direct et non approuvés, clairement signalés.
Tout ce qui est masqué sur le site web de votre ligue reste masqué dans l'API également.
Pas sûr que l'API vous convienne ?
Si vous ne voulez rien construire vous-même, les Code Snippets et League Embed affichent les données de votre ligue sur votre site web sans programmation. Voir Quelle intégration choisir ?.
LeagueRepublic ne propose pas de service de création de sites web ou d'applications sur mesure.