Aller au contenu

Versions et modules

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: @1793577600
Sunset: Mon, 03 May 2027 00:00:00 GMT
Link: </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 ;
  • Link rel="successor-version" : la version qui la remplace.

Aucune version n’est dépréciée aujourd’hui.

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.

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.

  • Chaque compétition (CompetitionRef partout où une compétition apparaît, les compétitions de /v1/competitions et les résultats de /v1/search) gagne logo : deux images PNG carrées, small en 32 × 32 px et large en 100 × 100 px, chacune avec son adresse, sa largeur et sa hauteur.
  • Seules les compétitions de football ont un logo pour l’instant ; logo vaut null pour les autres sports. Une compétition dont iDalgo n’a pas le fichier répond 404 à l’adresse donnée.
  • Chaque pays (Country : nationalités, pays d’une équipe, d’un arbitre, tableau des médailles) gagne flag : small, un PNG de 16 × 11 px, et svg, le drapeau vectoriel au format 3:2.
  • Chaque personne (PersonRef partout où une personne apparaît, et la fiche de /v1/persons/{id}) gagne photo : deux portraits JPEG au format 5:7, small en 50 × 70 px et large en 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.
  • Chaque équipe (TeamCompetitor, la fiche de /v1/teams/{id} et les résultats de /v1/search) gagne logo : deux images PNG carrées, small en 32 × 32 px pour une liste et large en 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 ; logo vaut null pour 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.
  • /modules/score-center/v1 et sa route /live : timeZone ne tient pas compte de la casse, et la réponse renvoie le nom canonique du fuseau (eUrOpE/pArIs donne Europe/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 »
  • status d’un contest (/v1/contests, vues live, modules) est une liste ouverte : le contrat le décrit en string avec les valeurs connues dans x-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) et internal-error (erreur inattendue, avec requestId).
  • meta.version donne la version du module pour /modules/<nom>/v<n> ; toutes les versions servies aujourd’hui sont v1.
  • Une version dépréciée l’annonce avec Deprecation, Sunset et Link rel="successor-version" (voir Ce qui peut changer).
  • Route inconnue : 404 en application/problem+json, code not-found, au lieu d’un texte 404 Not Found.
  • Erreur inattendue : 500 en application/problem+json, code internal-error, jamais gardée en cache, au lieu de { "error", "code": 500, "requestId" }.
  • kind et type sont des listes fermées, comme le contrat le décrit : cette page annonçait à tort de nouvelles valeurs de kind dans une version.

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/live en donne les tours à relire au rythme de meta.pollAfter.
  • Nouveaux codes d’erreur : phase-not-found et bracket-unavailable.
  • 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 dans periods (« Tirs au but »). Elle tenait lieu de score jusqu’ici.

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) ; previousDate et nextDate donnent les jours voisins qui ont des matchs, pour une navigation qui saute les jours vides. competitions choisit les compétitions et l’ordre des blocs ; sans lui, une liste par défaut du sport (football), et 400 pour un sport qui n’en a pas. La phase de chaque bloc porte son format (league, groups, knockout…, liste ouverte), comme dans /v1/seasons/{id}, ou null quand 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 de meta.pollAfter.
  • /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 de meta.pollAfter. Ajout, sans changement pour les intégrations existantes.
  • meta.pollAfter des 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.

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, null si les actions de la saison ne sont pas importées).
  • /v1/contests/{id}/lineups : positionLabel, le poste de chaque joueur (« Gardien », « Milieu »…), et coach, l’entraîneur de chaque équipe. Tous deux viennent de leur carrière dans l’équipe à la date du match, null si elle n’est pas connue.
  • /v1/seasons/{id}/leaders : team ne 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 de meta.pollAfter.
  • meta.pollAfter des 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.
  • position des joueurs de /v1/contests/{id}/lineups : x est bien la largeur du terrain (0 : gauche) et y sa 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).
  • highlights dans /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).

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. type limite à un type d’entité (competition, team, person) ; pas de pagination, limit borne 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[].height et squad[].weight : taille (cm) et poids (kg) de chaque membre de l’effectif, null s’ils ne sont pas connus. Également dans /v1/teams/{id}/squad.

Première version : fiche d’une personne, son engagement en cours et son parcours, en un appel.

Première version : fiche de l’équipe, effectif, forme récente et prochain match, en un appel.

Première version : saison, sélecteur de journées, journée affichée et ses matchs, en un appel.