Aller au contenu

Journal des changements

Chaque évolution qu’une intégration peut voir, la plus récente en premier : API (données JSON), Widgets (rendu et paramètres), SDK (script /sdk/v1.js et window.iDalgo) et Rendu serveur (intégration côté serveur). Le détail de l’API, champ par champ, est dans Versions et modules, qui signale aussi les corrections de comportement.

Une ligne marquée À vérifier change un comportement existant : relisez votre intégration. Les autres sont des ajouts, sans rien à changer de votre côté. La version déployée est donnée par iDalgo.version dans le navigateur et par meta.version des fragments.

  • API : les compétitions de football portent leur logo (logo, en 32 et 100 px) partout où une compétition apparaît.
  • Widgets : le logo de la compétition dans les blocs du Score Center et les compétitions de la fiche équipe.
  • Widgets : le Score Center s’affiche quand une compétition se joue en plusieurs saisons le même jour (Ligue des Nations, une par ligue) ; il restait vide.
  • API : chaque pays porte son drapeau (flag, PNG et SVG) et chaque personne son portrait (photo, en 50 et 100 px), tous sports confondus.
  • Widgets : portraits dans la fiche joueur, l’effectif, la composition et les joueurs clés ; drapeaux dans la fiche joueur, la fiche équipe et les arbitres ; logos dans les classements (widget et feuille de match), la fiche dépliée d’une équipe et ses derniers matchs.
  • API : les équipes de football portent leur logo (logo, en 32 et 100 px) partout où une équipe apparaît : matchs, classements, fiches, recherche.
  • Widgets : le logo des équipes de football remplace l’écusson neutre dans les cartes de match, la feuille de match, la fiche équipe et le tableau final.
  • Widgets : mode sombre, mode=dark, ou automatique, mode=auto, qui suit l’appareil du lecteur ; par widget ou pour tous dans votre thème, clair par défaut. L’interface des widgets reste en français, lang ne traduisant que les noms (voir Mode sombre et langue).
  • Widgets : votre thème habille désormais tous les widgets (feuille de match, Score Center, tableau final, liste de matchs…) : couleur de marque, fond, texte, bordures, police et arrondis. Le thème iDalgo par défaut passe aux couleurs d’iDalgo.
  • API, À vérifier : le Score Center renvoie dans timeZone le nom canonique du fuseau demandé (eUrOpE/pArIs donne Europe/Paris), quelle que soit sa casse (détail).
  • API : le tableau de phase finale et le Score Center d’un jour passé ne sont plus gardés 30 jours en cache tant qu’ils peuvent changer : un tour tout juste tiré ou un match reprogrammé apparaît dans les 10 minutes.
  • Widgets, Rendu serveur : après une mise à jour d’iDalgo, un widget ne reste plus figé (sans onglets, sélecteurs ni direct) faute de trouver son script ; un fragment d’historique se resert périmé (stale-while-revalidate) 5 jours au plus au lieu de 7.
  • Widgets : sur une page en https, les feuilles de style et les scripts des widgets se chargent de nouveau (ils étaient demandés en http:// et bloqués par le navigateur) : style, onglets, « Voir plus » et direct fonctionnent.
  • SDK : sans client ni data-idalgo-client, l’adresse des widgets ne porte plus client=idalgo ; avec votre clé, c’est elle qui désigne votre média.
  • SDK, API : votre clé passe en Authorization: Bearer, jamais dans l’URL : data-idalgo-key sur la balise du SDK ou iDalgo.configure({ key }) pour les widgets, la clé secrète pour votre serveur et l’assistant IA. Facultative pour l’instant.
  • Widgets : le direct suit votre offre, et live=false le coupe sur un widget, Score Center compris ; sans direct, un match en cours affiche « EN COURS », l’heure de ses données et un bouton « Actualiser ».
  • Widgets : votre identifiant client porte votre thème, vos valeurs par défaut (liens, langue, fuseau horaire) et vos sites autorisés ; un paramètre de la balise l’emporte sur une valeur par défaut.
  • Rendu serveur : une page hors des sites autorisés pour votre client reçoit 403 origin-not-allowed (voir Erreurs).
  • SDK : URL figée sur la version majeure, /sdk/v1.js ; /sdk.js reste l’alias de la v1 (voir Version du SDK).
  • SDK : une erreur porte apiCode (le code renvoyé par le serveur) et retryable ; le SDK réessaie aussi un 429, et n’affiche « Réessayer » que pour une erreur passagère (voir Erreurs).
  • Rendu serveur : une erreur porte un code stable, celui de l’API relayé (team-not-found…) ou ceux du serveur de rendu (component-not-found, data-source-unavailable, internal-error) (voir Erreurs).
  • API : status d’un contest en liste ouverte, codes d’erreur not-found et internal-error, en-têtes Deprecation, Sunset et Link sur une version dépréciée (aucune aujourd’hui).
  • API, À vérifier : une route inconnue répond 404 et une erreur inattendue 500, toutes deux en application/problem+json comme les autres erreurs.
  • Widgets : les styles d’un widget ne s’appliquent qu’à son conteneur ; plus aucune variable ni classe posée sur le reste de la page.
  • Rendu serveur : css=link donne les styles en URL (dom.styles), la feuille commune chargée une fois par page quel que soit le nombre de widgets ; le SDK procède ainsi (voir CSS).
  • Rendu serveur : dom.preload, les modules à précharger avec ceux de dom.js ; le SDK les précharge, ainsi que la police. Scripts des widgets minifiés.
  • Widgets : Score Center, les matchs d’un sport sur un jour, par compétition, en direct, avec son panneau Classement (gabarit de lien standings).
  • Widgets : tableau de phase finale (Bracket), en direct.
  • Widgets : police du design system (Atkinson Hyperlegible) servie par iDalgo et appliquée par défaut.
  • Widgets : scripts et feuilles à noms changeant à chaque version, gardés un an par le navigateur ; un fragment se garde un jour au plus.
  • Rendu serveur et API : réponses compressées (brotli, gzip) ; /render porte un ETag et répond 304 à un fragment inchangé. Le SDK se revalide de même.
  • API : modules /modules/score-center/v1 (avec le format de la phase de chaque bloc) et /modules/bracket/v1, avec leurs routes /live.
  • API, À vérifier : le score d’un match décidé aux tirs au but est celui de la fin du match ; la séance passe dans periods.
  • Widgets : liste de matchs : sélecteur de journée (navigation=selector), de compétition (competitions), mise en page de colonne étroite et bouton « Tous les matchs » (gabarit de lien results).
  • Widgets : fiche joueur (PlayerCard).
  • Widgets et SDK : liens vers vos pages joueur, équipe et match (configure({ links }), data-idalgo-link-*, link.* au rendu serveur) (voir Liens).
  • Widgets : classement : une ligne se déplie en fiche de l’équipe ; « Fiche complète » mène à sa page.
  • Widgets : la liste de matchs se met à jour en direct.
  • Widgets : un fragment se garde le temps de sa donnée la plus fraîche (meta.cacheControl), au lieu de 5 minutes.
  • Widgets : feuille de match (MatchSheet), en direct.
  • API : /modules/match-list/v1/live, les matchs d’une journée réduits à ce qui bouge.
  • API : /modules/match-sheet/v1 et sa route /live ; poste et entraîneur dans les compositions, team sur /v1/seasons/{id}/leaders.
  • API et SDK : appelables depuis les pages de tout site (CORS).
  • API, À vérifier : x et y des positions sur le terrain étaient inversés.
  • API : actions de match (/v1/contests/{id}/actions), temps forts du direct, classements de joueurs d’une saison (/v1/seasons/{id}/leaders), stats d’un joueur (/v1/persons/{id}/stats).
  • API : recherche par nom, /v1/search (compétitions, équipes, personnes).
  • API : serveur MCP, pour construire vos écrans sur l’API avec un assistant IA.
  • Widgets : fiche équipe (TeamSheet).
  • Widgets : chaque widget suit la largeur de son emplacement, pas celle de l’écran : en colonne étroite, il prend sa mise en page mobile.
  • SDK et Rendu serveur, À vérifier : un paramètre invalide répond 400 et une entité inconnue 404, au lieu de 502 ; le SDK ne réessaie plus une erreur 4xx.
  • API : modules /modules/team-sheet/v1 et /modules/player-card/v1.
  • Ouverture de ce portail de documentation, avec la référence de l’API.
  • API, À vérifier : l’API /v1 remplace les routes non versionnées (/competitions, /standings, /matches) : enveloppe { data, meta, links }, pagination par curseur, langue par ?lang=, erreurs application/problem+json et en-têtes de cache sur chaque réponse.
  • API : vues live /v1/live/contests, relues au rythme de meta.pollAfter.
  • API : /modules/match-list/v1, premier module de widget.