/v1/live/contests/{id}
const url = 'https://example.com/v1/live/contests/54732603?lang=ar';const options = {method: 'GET'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://example.com/v1/live/contests/54732603?lang=ar'Parameters
Section intitulée « Parameters »Path Parameters
Section intitulée « Path Parameters »Contest
Example
54732603Contest
Query Parameters
Section intitulée « Query Parameters »Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l’anglais, puis le français.
Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l’anglais, puis le français.
Responses
Section intitulée « Responses »Un contest réduit au statut, au score et aux périodes (podium pour une épreuve classée). meta.pollAfter : secondes avant la prochaine lecture, null quand plus rien ne bougera. Tant qu’elle se relit, en cache pollAfter secondes dans le navigateur (Cache-Control: public, max-age=<pollAfter>) et une minute au CDN, rafraîchie à chaque changement ; ensuite, la classe de son contenu.
object
Duel en direct, avec ses périodes et ses temps forts
object
Identifiant opaque d’un contest (match, course, épreuve)
Un sport : code pour le rendu, id pour filtrer les autres routes (?sport=)
object
Identifiant opaque d’un sport
Code stable d’un sport, qui choisit son profil de rendu ; other sans profil dédié. Liste ouverte : ignorer une valeur inconnue.
Instant ISO 8601 en UTC (2026-10-10T13:30:00.000Z)
Statut normalisé ; statusLabel donne le libellé exact de la source (« Mi-temps », « Manche 3 »…). Liste ouverte : ignorer une valeur inconnue.
Un camp d’un duel en direct : la part de ContestSide qui bouge
object
Score principal ; null tant que le match n’a pas commencé
Un camp d’un duel en direct : la part de ContestSide qui bouge
object
Score principal ; null tant que le match n’a pas commencé
Score d’une période pour chaque camp : mi-temps, set, tie-break…
object
Temps forts dans l’ordre du match : buts (dont contre son camp), expulsions (rouge direct, deuxième jaune), tirs au but. Toutes les actions : /v1/contests/{id}/actions
Une action de match : but, carton, remplacement, tir, faute…
object
Identifiant opaque d’une action de match (but, carton…)
Nature exacte d’une action (« but sur penalty », « deuxième carton jaune »…) ; label en donne le libellé traduit. Liste ouverte : ignorer une valeur inconnue.
Famille d’une action, pour filtrer les temps forts : goal réunit tous les buts marqués (de la tête, sur penalty…), hors buts contre son camp (own-goal) et buts refusés (disallowed-goal). Liste ouverte : ignorer une valeur inconnue.
Libellé de type (« But sur penalty »)
Minute de jeu. Le temps additionnel la prolonge au-delà de la fin de la période : 48 en « 1ère mi-temps » se lit 45+3. Un tir au but porte son rang dans la séance (1, 2, 3…)
Période de jeu (« 1ère mi-temps », « Tirs au but »…)
Une personne : athlète, joueur, arbitre
object
Identifiant opaque d’une personne (athlète, arbitre)
Portrait d’une personne, en JPEG au format 5:7 : small en 50 × 70 px (liste, composition), large en 100 × 141 px (fiche). Beaucoup de personnes n’ont pas de portrait : l’adresse répond alors 404, prévoyez un repli (silhouette neutre)
object
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Auteur : buteur, passeur décisif, joueur averti, joueur entrant…
Une personne : athlète, joueur, arbitre
object
Identifiant opaque d’une personne (athlète, arbitre)
Portrait d’une personne, en JPEG au format 5:7 : small en 50 × 70 px (liste, composition), large en 100 × 141 px (fiche). Beaucoup de personnes n’ont pas de portrait : l’adresse répond alors 404, prévoyez un repli (silhouette neutre)
object
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Seconde personne : buteur servi par une passe décisive, joueur sortant d’un remplacement. Un but n’en a pas : sa passe décisive est une action à part, à la même minute
Heure de l’action, si connue
Épreuve classée en direct : le podium du moment
object
Identifiant opaque d’un contest (match, course, épreuve)
Un sport : code pour le rendu, id pour filtrer les autres routes (?sport=)
object
Identifiant opaque d’un sport
Code stable d’un sport, qui choisit son profil de rendu ; other sans profil dédié. Liste ouverte : ignorer une valeur inconnue.
Instant ISO 8601 en UTC (2026-10-10T13:30:00.000Z)
Statut normalisé ; statusLabel donne le libellé exact de la source (« Mi-temps », « Manche 3 »…). Liste ouverte : ignorer une valeur inconnue.
Un concurrent d’une épreuve classée ; position vaut null pour un non classé
object
Une équipe
object
Identifiant opaque d’une équipe
Logo d’une équipe, en PNG carré : small en 32 × 32 px (liste, tableau), large en 100 × 100 px (fiche, en-tête de match). Servi pour les équipes de football, null pour les autres sports. Une équipe dont iDalgo n’a pas le fichier répond 404 à cette adresse : prévoyez un repli (écusson neutre)
object
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Un athlète seul
object
Identifiant opaque d’une personne (athlète, arbitre)
Portrait d’une personne, en JPEG au format 5:7 : small en 50 × 70 px (liste, composition), large en 100 × 141 px (fiche). Beaucoup de personnes n’ont pas de portrait : l’adresse répond alors 404, prévoyez un repli (silhouette neutre)
object
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Plusieurs athlètes sans équipe (relais, double) ; name réunit leurs noms
object
Identifiant opaque d’un équipage (relais, double)
Une personne : athlète, joueur, arbitre
object
Identifiant opaque d’une personne (athlète, arbitre)
Portrait d’une personne, en JPEG au format 5:7 : small en 50 × 70 px (liste, composition), large en 100 × 141 px (fiche). Beaucoup de personnes n’ont pas de portrait : l’adresse répond alors 404, prévoyez un repli (silhouette neutre)
object
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
object
Date de génération de la réponse
Version du contrat de la réponse : v1 pour une ressource /v1, celle du module pour un module (/modules/<nom>/v<n> → v<n>)
Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l’anglais, puis le français.
Secondes avant de relire la vue (plus court pour les sports rapides) ; null quand plus rien ne bougera (tout est terminé, reporté ou annulé) : le widget s’arrête
object
Chemin de la ressource, paramètres triés
Example
{ "data": { "type": "head-to-head", "highlights": [ { "side": "home" } ] }, "meta": { "version": "v1", "lang": "ar" }}Contenu inchangé depuis l’ETag envoyé en If-None-Match
Paramètre invalide ou inconnu
Erreur au format application/problem+json (RFC 9457)
object
Code stable d’une erreur de l’API. Liste ouverte : ignorer une valeur inconnue.
Explication propre à cette requête
Identifiant de la requête (aussi en en-tête X-Request-Id) sur une erreur internal-error, à donner au support
Example generated
{ "type": "example", "title": "example", "status": 1, "code": "example", "detail": "example", "requestId": "example"}Contest inconnu
Erreur au format application/problem+json (RFC 9457)
object
Code stable d’une erreur de l’API. Liste ouverte : ignorer une valeur inconnue.
Explication propre à cette requête
Identifiant de la requête (aussi en en-tête X-Request-Id) sur une erreur internal-error, à donner au support
Example generated
{ "type": "example", "title": "example", "status": 1, "code": "example", "detail": "example", "requestId": "example"}