Aller au contenu

Feuille de match

La feuille d’un match entre deux équipes, en quatre onglets sous un en-tête qui donne la compétition, la date, le score (ou l’heure du coup d’envoi), le score à la mi-temps, la place de chaque équipe au classement et les buteurs :

  • Informations du match : arbitres, stade, capacité, affluence.
  • Actions du match : buts (avec le score au tableau), cartons et remplacements dans l’ordre du match, avec une coupure à chaque fin de période.
  • Composition : le système de jeu de chaque équipe, ses titulaires placés sur le terrain avec leurs buts, cartons et sorties, son entraîneur et ses remplaçants avec leur minute d’entrée.
  • Avant-match : la forme récente des deux équipes, leurs performances de la saison (victoires, nuls, défaites, buts pour et contre), leurs joueurs clés (meilleur buteur, meilleur passeur), le bilan de leurs confrontations et les dernières d’entre elles.

En colonne, le classement de la poule à la date du match (général, domicile, extérieur) et la forme récente des deux équipes. En dessous de 960 px, la colonne passe sous le contenu ; en dessous de 640 px, le terrain ne garde que les numéros. Les dates et heures sont affichées dans le fuseau de vos lecteurs (timezone, par défaut l’heure de Paris).

Premier League Saison régulière

Arsenal 1er • 39 pts
Manchester City 2e • 37 pts
Terminé 2 – 1 mi-temps 1 – 0

  • But Gyökeres 45’
  • But Saka (pen.) 67’
  • But Haaland 48’
Principal
Michael Oliver
Stade
Emirates Stadium
Capacité
60 704 places
Affluence
59 842 spectateurs
Intégration
<div
data-idalgo-component="MatchSheet"
data-idalgo-param-contest="54732603"
></div>
<script src="https://delivery.idalgo.live/sdk/v1.js" async></script>
Paramètre Obligatoire Description Exemple
contest Oui Match (id d’un contest de type head-to-head entre deux équipes) 54732603
tab Non Onglet ouvert à l’affichage : info (défaut), actions, lineups ou preview lineups
lang Non Langue des noms (défaut fr) ; l’interface reste en français (voir Langue) en
mode Non Mode : light (défaut), dark ou auto, qui suit le réglage de l’appareil du lecteur ; par défaut, celui de votre thème (voir Mode sombre) dark
timezone Non Fuseau horaire de vos lecteurs (IANA), pour les dates et heures affichées (défaut Europe/Paris) America/Montreal
live Non false : coupe le direct de ce widget ; par défaut, celui de votre offre false

Un match à venir n’a ni actions ni composition : ses onglets le disent, et l’avant-match donne la forme et les confrontations à la veille du match. Les joueurs clés et les actions n’apparaissent que pour une saison dont les actions de match sont importées ; le classement, que pour une saison qui en a un.

Pendant le match, le widget se met à jour seul : score, statut, mi-temps, buteurs, actions et compositions, sans recharger la page. Il commence à se relire 90 minutes avant le coup d’envoi (heure de publication des compositions), au rythme indiqué par l’API (toutes les minutes avant le match, puis toutes les 10 secondes en football à partir d’un quart d’heure avant le coup d’envoi), et s’arrête de lui-même à la fin du match. Un onglet de navigateur caché ne relit rien ; il se remet à jour dès qu’il redevient visible. L’avant-match, le classement et la forme ne bougent pas pendant le match.

Sans direct, selon votre offre ou avec live=false, le widget reste tel qu’affiché ; un match en cours le signale, avec l’heure des données et un bouton « Actualiser » (voir Direct).

En erreur, le widget n’est pas rendu : le SDK affiche « Impossible de charger le widget », avec un bouton « Réessayer » si l’erreur est passagère (réseau, serveur), ou appelle votre onError (voir SDK) ; en intégration côté serveur, la réponse porte le statut, un message et un code stable { "error": "…", "code": "…" }.

Statut Cas Code de l’API
400 contest absent ou non numérique ; lang, timezone ou mode invalide invalid-request
404 Match inconnu, ou qui n’est pas un duel entre deux équipes contest-not-found
502 API iDalgo injoignable ou réponse non conforme —

Ce qui manque encore au match s’affiche dans son onglet :

  • Informations du match : « Les informations du match ne sont pas encore connues. » ;
  • Actions du match : « Le match n’a pas encore commencé. » avant le coup d’envoi, « Les actions de ce match ne sont pas disponibles. » pour une saison dont les actions ne sont pas importées ;
  • Composition : « Les compositions ne sont pas encore connues. » ;
  • Avant-match : « Première confrontation entre ces deux équipes. » sans confrontation passée.

En direct, une relecture en échec est retentée 30 secondes plus tard, et le widget garde les dernières données affichées.

Le widget lit le module GET /modules/match-sheet/v1, puis, pendant le match, sa route live GET /modules/match-sheet/v1/live : les mêmes données sont disponibles en JSON pour vos propres interfaces.