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).
<div data-idalgo-component="MatchList" data-idalgo-param-season="374703"></div><script src="https://delivery.idalgo.live/sdk/v1.js" async></script>Paramètres
Section intitulée « Paramètres »| 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 |
Navigation
Section intitulée « Navigation »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.
Colonne latérale
Section intitulée « Colonne latérale »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.
En direct
Section intitulée « En direct »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).
Erreurs et états
Section intitulée « Erreurs et états »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.