Aller au contenu

Matchs

Les matchs d’une journée, avec un bouton « Voir plus » qui charge la journée suivante, ou, au choix, une liste des journées encadrée de flèches. Chaque match affiche son état : l’heure s’il est à venir, le score en direct ou une fois terminé (vainqueur en gras), ou « Reporté ». Les dates et heures sont affichées dans le fuseau de vos lecteurs (timezone, par défaut l’heure de Paris).

Ligue 1 2026/2027

Journée 9

dimanche 11 octobre
  • 11.10
    Paris Saint-Germain
    Olympique de Marseille
    21
    Terminé 11.10
  • 11.10
    AS Monaco
    Lille OSC
    00
    Terminé 11.10
  • 11.10
    OGC Nice
    Olympique Lyonnais
    13
    Terminé 11.10
  • 11.10
    RC Lens
    Stade Rennais
    42
    Terminé 11.10
  • 11.10
    Stade Brestois
    Toulouse FC
    10
    Terminé 11.10
  • 11.10
    RC Strasbourg
    Montpellier HSC
    11
    EN DIRECT 11.10
  • 12.10
    Stade de Reims
    FC Nantes
    15:00 12.10
  • 12.10
    AJ Auxerre
    Angers SCO
    20:45 12.10
  • 12.10
    Le Havre AC
    AS Saint-Étienne
    Reporté 12.10
Intégration
<div
data-idalgo-component="MatchList"
data-idalgo-param-season="374703"
></div>
<script src="https://delivery.idalgo.live/sdk/v1.js" async></script>
Paramètre Obligatoire Description Exemple
season Oui Saison (currentSeason.id de /v1/competitions) 374703
day Non Journée affichée ; par défaut, la journée courante 10663103
navigation Non selector : liste des journées et flèches au-dessus des matchs, au lieu du bouton « Voir plus » selector
competitions Non Compétitions proposées dans une liste au-dessus des matchs (ids de /v1/competitions, dans l’ordre) 103,503
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

Par défaut, « Voir plus » ajoute la journée suivante sous celles déjà affichées. Avec navigation=selector, le widget affiche une seule journée à la fois, choisie dans une liste (« Journée 20 · 30.11 », précédée du nom de la phase quand la saison en compte plusieurs) ou avec les flèches précédent et suivant ; la date de la journée s’affiche au-dessus de ses matchs.

Avec competitions, une liste propose ces compétitions au-dessus des matchs. En choisir une affiche la journée courante de sa saison en cours : la liste reste valable d’une saison à l’autre. Une compétition sans saison en cours n’y figure pas, et le sélecteur n’apparaît qu’à partir de deux compétitions. La saison de season doit être celle de l’une d’elles pour que la liste la montre sélectionnée.

En colonne étroite (moins de 640 px de large, une colonne latérale d’article par exemple), la date de chaque match passe sous son heure. Si vous avez donné au SDK le gabarit de lien results (voir Liens), un bouton « Tous les matchs » sous la liste mène à votre page de résultats de la saison affichée.

Les matchs se mettent à jour seuls, sans recharger la page : passage en direct, score, fin du match. Chaque journée affichée, y compris celles ajoutées par « Voir plus » ou choisies dans la liste, se relit à partir de 90 minutes avant son premier coup d’envoi, au rythme indiqué par l’API (toutes les 10 secondes pendant un match de football), et s’arrête quand tous ses matchs sont terminés. Un onglet de navigateur caché ne relit rien ; il se remet à jour dès qu’il redevient visible.

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 season absent ou non numérique ; day, lang, timezone ou mode invalide invalid-request
404 Saison inconnue season-not-found
404 day absente de la saison day-not-found
502 API iDalgo injoignable ou réponse non conforme —

Une compétition de competitions inconnue ou sans saison en cours est écartée de la liste, sans erreur. Une saison sans journée affiche « Aucun match programmé. ». Si « Voir plus », la liste des journées ou celle des compétitions ne parvient pas à charger les matchs, le widget affiche « La journée n’a pas pu être chargée. » et garde ses contrôles pour réessayer.

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-list/v1, puis, pendant les matchs, sa route live GET /modules/match-list/v1/live : les mêmes données sont disponibles en JSON pour vos propres interfaces.