Versions et modules
Deux familles de routes
Section intitulée « Deux familles de routes »- Ressources
/v1/…: une route par entité (compétitions, saisons, classements, contests, équipes). Le contrat public de base. - Modules
/modules/<nom>/v<n>: un document prêt à afficher par widget, qui assemble plusieurs ressources en un seul appel (par exemple/modules/match-list/v1ou/modules/team-sheet/v1,/modules/player-card/v1,/modules/match-sheet/v1,/modules/score-center/v1ou/modules/bracket/v1). Chaque module a sa propre version.
Ce qui peut changer
Section intitulée « Ce qui peut changer »Dans /v1 et dans une version de module, les évolutions sont uniquement additives : nouveaux
champs, nouvelles routes, nouvelles valeurs d’une liste ouverte
(status d’un contest, code d’erreur…). Ignorez les champs que vous ne connaissez pas. kind et
type, qui fixent la forme d’un objet, ne gagnent pas de valeur dans une version.
Renommer, retirer ou changer le type d’un champ passe par une nouvelle version (/v2, ou v2
d’un module), dont meta.version porte le numéro. L’ancienne version continue de répondre jusqu’à
sa date de fin, et l’annonce sur chacune de ses réponses :
Deprecation: @1793577600Sunset: Mon, 03 May 2027 00:00:00 GMTLink: </modules/match-list/v2>; rel="successor-version"Deprecation(RFC 9745) : la date de la dépréciation, en secondes Unix précédées de@;Sunset(RFC 8594) : la date après laquelle la version ne répondra plus ;Linkrel="successor-version": la version qui la remplace.
Aucune version n’est dépréciée aujourd’hui.
Corrections de comportement
Section intitulée « Corrections de comportement »Une correction rend au contrat ce qu’il annonçait déjà (une valeur fausse, des axes inversés, une erreur hors du format documenté) : elle s’applique dans la version en cours, sans nouvelle version. Chaque entrée ci-dessous les signale sous « Corrections de comportement » : vérifiez-les, une intégration qui s’appuyait sur l’ancien comportement doit s’adapter.
Dernières évolutions
Section intitulée « Dernières évolutions »Le détail de chaque champ est dans la référence. Les évolutions des widgets et du SDK sont dans le journal des changements, qui reprend aussi celles-ci en une ligne.
16 novembre 2026 — logos des compétitions
Section intitulée « 16 novembre 2026 — logos des compétitions »- Chaque compétition (
CompetitionRefpartout où une compétition apparaît, les compétitions de/v1/competitionset les résultats de/v1/search) gagnelogo: deux images PNG carrées,smallen 32 × 32 px etlargeen 100 × 100 px, chacune avec son adresse, sa largeur et sa hauteur. - Seules les compétitions de football ont un logo pour l’instant ;
logovautnullpour les autres sports. Une compétition dont iDalgo n’a pas le fichier répond 404 à l’adresse donnée.
13 novembre 2026 — drapeaux et portraits
Section intitulée « 13 novembre 2026 — drapeaux et portraits »- Chaque pays (
Country: nationalités, pays d’une équipe, d’un arbitre, tableau des médailles) gagneflag:small, un PNG de 16 × 11 px, etsvg, le drapeau vectoriel au format 3:2. - Chaque personne (
PersonRefpartout où une personne apparaît, et la fiche de/v1/persons/{id}) gagnephoto: deux portraits JPEG au format 5:7,smallen 50 × 70 px etlargeen 100 × 141 px. - Ces deux champs valent pour tous les sports. Beaucoup de personnes n’ont pas de portrait : l’adresse répond alors 404, prévoyez une silhouette neutre.
13 novembre 2026 — logos d’équipe
Section intitulée « 13 novembre 2026 — logos d’équipe »- Chaque équipe (
TeamCompetitor, la fiche de/v1/teams/{id}et les résultats de/v1/search) gagnelogo: deux images PNG carrées,smallen 32 × 32 px pour une liste etlargeen 100 × 100 px pour une fiche, chacune avec son adresse (url), sa largeur et sa hauteur. - Seules les équipes de football ont un logo pour l’instant ;
logovautnullpour les autres sports. - Une équipe dont iDalgo n’a pas le fichier répond 404 à l’adresse donnée : prévoyez un repli, comme un écusson neutre.
6 novembre 2026 — fuseau du Score Center
Section intitulée « 6 novembre 2026 — fuseau du Score Center »Corrections de comportement
Section intitulée « Corrections de comportement »/modules/score-center/v1et sa route/live:timeZonene tient pas compte de la casse, et la réponse renvoie le nom canonique du fuseau (eUrOpE/pArIsdonneEurope/Paris) au lieu de la graphie reçue. Écrivez le fuseau sous son nom canonique : chaque graphie est une adresse de plus à mettre en cache.
2 novembre 2026 — erreurs, listes ouvertes et dépréciations
Section intitulée « 2 novembre 2026 — erreurs, listes ouvertes et dépréciations »statusd’un contest (/v1/contests, vues live, modules) est une liste ouverte : le contrat le décrit enstringavec les valeurs connues dansx-extensible-enum, et un client généré ne rejettera pas un statut ajouté plus tard. Le filtre?status=garde sa liste fermée.- Nouveaux codes d’erreur :
not-found(route inconnue) etinternal-error(erreur inattendue, avecrequestId). meta.versiondonne la version du module pour/modules/<nom>/v<n>; toutes les versions servies aujourd’hui sontv1.- Une version dépréciée l’annonce avec
Deprecation,SunsetetLinkrel="successor-version"(voir Ce qui peut changer).
Corrections de comportement
Section intitulée « Corrections de comportement »- Route inconnue :
404enapplication/problem+json, codenot-found, au lieu d’un texte404 Not Found. - Erreur inattendue :
500enapplication/problem+json, codeinternal-error, jamais gardée en cache, au lieu de{ "error", "code": 500, "requestId" }. kindettypesont des listes fermées, comme le contrat le décrit : cette page annonçait à tort de nouvelles valeurs dekinddans une version.
29 octobre 2026 — tableau de phase finale
Section intitulée « 29 octobre 2026 — tableau de phase finale »Ajouts, sans changement pour les intégrations existantes.
/modules/bracket/v1: première version. Le tableau d’une phase à élimination de football (?season=&phase=,phaseétant le premier tour affiché), de ce tour à la finale : chaque opposition avec ses deux équipes, le score de chaque match (aller, retour, ou match unique), le cumul, les tirs au but quand une séance a départagé l’opposition, le qualifié et l’opposition du tour suivant où il se retrouve (nextPosition)./modules/bracket/v1/liveen donne les tours à relire au rythme demeta.pollAfter.- Nouveaux codes d’erreur :
phase-not-foundetbracket-unavailable.
Corrections de comportement
Section intitulée « Corrections de comportement »- Score d’un match décidé aux tirs au but (
/v1/contests, vues live, modules) : c’est le score à la fin du match, prolongations comprises ; la séance de tirs au but passe dansperiods(« Tirs au but »). Elle tenait lieu de score jusqu’ici.
29 octobre 2026 — Score Center
Section intitulée « 29 octobre 2026 — Score Center »Ajouts, sans changement pour les intégrations existantes.
/modules/score-center/v1: première version. Les matchs d’un sport sur un jour, groupés par compétition (compétition, saison, phase, journée et son rang pour l’en-tête « Journée 17 »), filtrables par statut (live,finished,scheduled). Le jour s’entend dans le fuseau du média (timeZone, Europe/Paris par défaut) ;previousDateetnextDatedonnent les jours voisins qui ont des matchs, pour une navigation qui saute les jours vides.competitionschoisit les compétitions et l’ordre des blocs ; sans lui, une liste par défaut du sport (football), et400pour un sport qui n’en a pas. La phase de chaque bloc porte sonformat(league,groups,knockout…, liste ouverte), comme dans/v1/seasons/{id}, ounullquand la source ne permet pas de le déduire : en phase à élimination (knockout), pas de classement à ouvrir./modules/score-center/v1/live: les mêmes matchs réduits à ce qui bouge (statut, score, heure), dans l’ordre des blocs, à relire au rythme demeta.pollAfter.
27 octobre 2026 — liste de matchs en direct
Section intitulée « 27 octobre 2026 — liste de matchs en direct »/modules/match-list/v1/live: les matchs d’une journée réduits à ce qui bouge (statut, score, heure), au format des vues/v1/live, à relire au rythme demeta.pollAfter. Ajout, sans changement pour les intégrations existantes.meta.pollAfterdes vues live : un match resté « à venir » plus de 6 heures après son coup d’envoi (statut plus mis à jour à la source) ne fait plus relire la vue, comme un match « en direct » depuis plus de 6 heures.
26 octobre 2026 — feuille de match
Section intitulée « 26 octobre 2026 — feuille de match »Ajouts, sans changement pour les intégrations existantes.
/modules/match-sheet/v1: première version. La feuille d’un match entre deux équipes en un appel : le match en détail (score, périodes, stade, affluence, arbitres), ses buts, cartons, remplacements et tirs au but (actions), les compositions, le classement de sa poule à la date du match (général, domicile, extérieur), la forme des deux équipes et leurs confrontations avant le match, et leurs joueurs clés sur la saison (meilleur buteur et meilleur passeur,nullsi les actions de la saison ne sont pas importées)./v1/contests/{id}/lineups:positionLabel, le poste de chaque joueur (« Gardien », « Milieu »…), etcoach, l’entraîneur de chaque équipe. Tous deux viennent de leur carrière dans l’équipe à la date du match,nullsi elle n’est pas connue./v1/seasons/{id}/leaders:teamne classe que les joueurs d’une équipe, sur ses matchs de la saison./modules/match-sheet/v1/live: ce qui bouge sur la feuille pendant le match (en-tête, actions, compositions), sous la même forme que le module, à relire au rythme demeta.pollAfter.meta.pollAfterdes vues live : un match encore à venir se relit au rythme du direct à partir d’un quart d’heure avant son coup d’envoi (et jusqu’à 30 minutes après s’il n’est pas passé en direct), au lieu d’une fois par minute.- Navigateur : l’API et le SDK répondent aux pages de tout site (CORS), et le SDK se charge par un
<script src>depuis n’importe quel domaine.
Corrections de comportement
Section intitulée « Corrections de comportement »positiondes joueurs de/v1/contests/{id}/lineups:xest bien la largeur du terrain (0 : gauche) etysa longueur (0 : le but de l’équipe), comme le contrat l’annonce ; les deux axes étaient inversés.
23 octobre 2026 — actions de match, classements de joueurs, stats de saison
Section intitulée « 23 octobre 2026 — actions de match, classements de joueurs, stats de saison »Ajouts, sans changement pour les intégrations existantes.
/v1/contests/{id}/actions: les actions d’un match dans l’ordre du jeu (buts, passes décisives, cartons, remplacements, tirs, fautes, VAR).highlightsdans/v1/live/contests/{id}: les temps forts d’un match en direct (buts, expulsions, tirs au but)./v1/seasons/{id}/leaders: buteurs, passeurs et cartons d’une saison./v1/persons/{id}/stats: matchs joués, titularisations, entrées et sorties, minutes, buts (dont sur penalty), passes décisives et cartons d’un joueur sur une saison./modules/player-card/v1:latestSeason, la dernière saison du joueur, toutes compétitions : pour chacune ses stats, son bilan (victoires, nuls, défaites) et ses matchs joués, plus le total.
Les actions ne sont importées que pour une partie des compétitions : classements et stats ne sont
servis que pour une saison dont presque tous les matchs joués ont leurs actions (sinon 404
leaders-unavailable ou person-stats-unavailable, et stats: null dans latestSeason).
22 octobre 2026 — recherche par nom
Section intitulée « 22 octobre 2026 — recherche par nom »Ajout, sans changement pour les intégrations existantes.
/v1/search: compétitions, équipes et personnes par leur nom (?q=, de 1 à 5 mots dont un d’au moins 3 caractères), en français ou en anglais, sans tenir compte des accents, de la casse ni de l’ordre des mots. Le nom identique vient en premier, puis ceux qui commencent par la recherche.typelimite à un type d’entité (competition,team,person) ; pas de pagination,limitborne le nombre de résultats (10 par défaut, 50 au plus).
20 octobre 2026 — /modules/team-sheet/v1 : compétitions, taille et poids
Section intitulée « 20 octobre 2026 — /modules/team-sheet/v1 : compétitions, taille et poids »Ajouts, sans changement pour les intégrations existantes.
competitions: les compétitions en cours de l’équipe (un match joué depuis 120 jours ou à venir), ou la saison passée en?season=. Pour chacune : son bilan (record: victoires, nuls, défaites, part de victoires, matchs à domicile et à l’extérieur, buts marqués et encaissés), le nombre de matchs restant à jouer (remaining) et tous ses matchs de la saison (contests, dans l’ordre chronologique). La plus fournie vient en premier.squad[].heightetsquad[].weight: taille (cm) et poids (kg) de chaque membre de l’effectif,nulls’ils ne sont pas connus. Également dans/v1/teams/{id}/squad.
20 octobre 2026 — /modules/player-card/v1
Section intitulée « 20 octobre 2026 — /modules/player-card/v1 »Première version : fiche d’une personne, son engagement en cours et son parcours, en un appel.
20 octobre 2026 — /modules/team-sheet/v1
Section intitulée « 20 octobre 2026 — /modules/team-sheet/v1 »Première version : fiche de l’équipe, effectif, forme récente et prochain match, en un appel.
14 octobre 2026 — /modules/match-list/v1
Section intitulée « 14 octobre 2026 — /modules/match-list/v1 »Première version : saison, sélecteur de journées, journée affichée et ses matchs, en un appel.