Aller au contenu

Feuille de match en direct (module MatchSheet v1)

GET
/modules/match-sheet/v1/live
curl --request GET \
--url 'https://example.com/modules/match-sheet/v1/live?contest=54732603&lang=ar'

Relue par le widget après le chargement de la feuille complète, tant que meta.pollAfter n’est pas null : en-tête (statut, score, périodes), actions et compositions, sous la même forme que dans /modules/match-sheet/v1. 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.

contest
required

Match

string
>= 1 characters /^\d+$/

Example

54732603

Match

lang

Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l’anglais, puis le français.

string
Allowed values: ar da de en es fa fi fr it ja ko nl no pl pt ro ru sv th tr zh

Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l’anglais, puis le français.

Ce qui bouge sur la feuille : en-tête, actions et compositions. meta.pollAfter : secondes avant la prochaine lecture, null quand plus rien ne bougera.

Media typeapplication/json
object
data
required

Ce qui bouge sur la feuille pendant le match : en-tête (statut, score, périodes), actions et compositions, sous la même forme que le module. Le widget remplace ces trois parties de la feuille chargée une fois, l’avant-match ne bougeant pas.

object
contest
required

Un duel en détail : périodes, stade, affluence, arbitres

object
type
required
string
Allowed values: head-to-head
id
required

Identifiant opaque d’un contest (match, course, épreuve)

string
>= 1 characters
sport
required

Un sport : code pour le rendu, id pour filtrer les autres routes (?sport=)

object
id
required

Identifiant opaque d’un sport

string
>= 1 characters
code
required

Code stable d’un sport, qui choisit son profil de rendu ; other sans profil dédié. Liste ouverte : ignorer une valeur inconnue.

string
>= 1 characters
name
required
string
nullable
competition
required

Une compétition (Ligue 1, NBA, Jeux olympiques…)

object
id
required

Identifiant opaque d’une compétition

string
>= 1 characters
name
required
string
nullable
logo
required
Any of:

Logo d’une compétition, en PNG carré : small en 32 × 32 px (liste, en-tête de bloc), large en 100 × 100 px (fiche). Servi pour les compétitions de football, null pour les autres sports. Une compétition dont iDalgo n’a pas le fichier répond 404 à cette adresse : prévoyez un repli (nom seul)

object
small
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
large
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
season
required

Une saison de compétition (« Ligue 1 2026/2027 »)

object
id
required

Identifiant opaque d’une saison de compétition

string
>= 1 characters
name
required
string
nullable
phase
required
Any of:

Une phase de la saison (saison régulière, play-offs…)

object
id
required

Identifiant opaque d’une phase

string
>= 1 characters
name
required
string
nullable
group
required
Any of:

Une poule d’une phase

object
id
required

Identifiant opaque d’une poule

string
>= 1 characters
name
required
string
nullable
day
required
Any of:

Une journée de la saison, et sa date

object
id
required

Identifiant opaque d’une journée

string
>= 1 characters
date
required

Jour calendaire ISO 8601 (2026-10-10)

string format: date
nullable
startsAt
required

Instant ISO 8601 en UTC (2026-10-10T13:30:00.000Z)

string format: date-time
nullable
status
required

Statut normalisé ; statusLabel donne le libellé exact de la source (« Mi-temps », « Manche 3 »…). Liste ouverte : ignorer une valeur inconnue.

string
>= 1 characters
statusLabel
required
string
nullable
venue
required
Any of:

Un stade ou un site, avec sa capacité

object
id
required

Identifiant opaque d’un stade ou d’un site

string
>= 1 characters
name
required
string
nullable
capacity
required
integer
nullable
home
required

Un camp d’un duel et son score principal

object
competitor
required
One of: discriminator: type

Une équipe

object
type
required
string
Allowed values: team
id
required

Identifiant opaque d’une équipe

string
>= 1 characters
name
required
string
nullable
logo
required
Any of:

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
small
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
large
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
score
required

null tant que le contest n’a pas commencé

number
nullable
away
required

Un camp d’un duel et son score principal

object
competitor
required
One of: discriminator: type

Une équipe

object
type
required
string
Allowed values: team
id
required

Identifiant opaque d’une équipe

string
>= 1 characters
name
required
string
nullable
logo
required
Any of:

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
small
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
large
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
score
required

null tant que le contest n’a pas commencé

number
nullable
audience
required
integer
nullable
officials
required
Array<object>

Un arbitre ou officiel, et sa nationalité

object
role
required

Rôle (« Principal », « Assistant »…)

string
nullable
person
required

Une personne : athlète, joueur, arbitre

object
id
required

Identifiant opaque d’une personne (athlète, arbitre)

string
>= 1 characters
name
required
string
nullable
photo
required
Any of:

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
small
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
large
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
country
required
Any of:

Un pays ; code est null si la source n’en a pas

object
id
required

Identifiant opaque d’un pays

string
>= 1 characters
name
required
string
nullable
code
required

Code CIO du pays (FRA) ; à défaut, son code iDalgo (VA)

string
nullable /^[A-Z]{2,3}$/
flag
required
Any of:

Drapeau d’un pays : small en PNG 16 × 11 px, svg vectoriel au format 3:2. Un pays dont iDalgo n’a pas le fichier répond 404 à ces adresses : prévoyez un repli

object
small
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
svg
required

Le drapeau en SVG, au format 3:2, net à toute taille

string format: uri
periods
required
Array<object>

Score d’une période pour chaque camp : mi-temps, set, tie-break…

object
name
required
string
nullable
home
required
number
nullable
away
required
number
nullable
actions
required

Buts, cartons, remplacements et tirs au but, dans l’ordre du match ; vide si le match n’a pas commencé ou si ses actions ne sont pas importées

Array<object>

Une action de match : but, carton, remplacement, tir, faute…

object
id
required

Identifiant opaque d’une action de match (but, carton…)

string
>= 1 characters
type
required

Nature exacte d’une action (« but sur penalty », « deuxième carton jaune »…) ; label en donne le libellé traduit. Liste ouverte : ignorer une valeur inconnue.

string
>= 1 characters
family
required

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.

string
>= 1 characters
label
required

Libellé de type (« But sur penalty »)

string
nullable
minute
required

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…)

number
nullable
period
required

Période de jeu (« 1ère mi-temps », « Tirs au but »…)

string
nullable
side
required
Any of:

Camp d’un duel : à domicile ou à l’extérieur

string
Allowed values: home away
person
required
Any of:

Une personne : athlète, joueur, arbitre

object
id
required

Identifiant opaque d’une personne (athlète, arbitre)

string
>= 1 characters
name
required
string
nullable
photo
required
Any of:

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
small
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
large
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
relatedPerson
required
Any of:

Une personne : athlète, joueur, arbitre

object
id
required

Identifiant opaque d’une personne (athlète, arbitre)

string
>= 1 characters
name
required
string
nullable
photo
required
Any of:

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
small
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
large
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
occurredAt
required

Heure de l’action, si connue

string format: date-time
nullable
lineups
required

Composition de chaque équipe ; titulaires et remplaçants vides si elle n’est pas connue

Array<object>

Composition d’un camp : système de jeu, titulaires, remplaçants, entraîneur

object
competitor
required
One of: discriminator: type

Une équipe

object
type
required
string
Allowed values: team
id
required

Identifiant opaque d’une équipe

string
>= 1 characters
name
required
string
nullable
logo
required
Any of:

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
small
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
large
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
formation
required

Système de jeu (« 4-3-3 »)

string
nullable
starters
required
Array<object>

Un joueur d’une composition ; position (place sur le terrain) vaut null pour un remplaçant

object
person
required

Une personne : athlète, joueur, arbitre

object
id
required

Identifiant opaque d’une personne (athlète, arbitre)

string
>= 1 characters
name
required
string
nullable
photo
required
Any of:

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
small
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
large
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
shirt
required

Numéro de maillot

integer
nullable
captain
required
boolean
position
required
Any of:

Coordonnées sur le terrain : x en % de sa largeur (0 : gauche), y en % de sa longueur (0 : le but de l’équipe)

object
x
required
number
<= 100
y
required
number
<= 100
positionLabel
required

Poste du joueur (« Gardien », « Milieu »…), d’après sa carrière dans l’équipe à la date du match ; null si elle ne le dit pas

string
nullable
substitutes
required
Array<object>

Un joueur d’une composition ; position (place sur le terrain) vaut null pour un remplaçant

object
person
required

Une personne : athlète, joueur, arbitre

object
id
required

Identifiant opaque d’une personne (athlète, arbitre)

string
>= 1 characters
name
required
string
nullable
photo
required
Any of:

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
small
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
large
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
shirt
required

Numéro de maillot

integer
nullable
captain
required
boolean
position
required
Any of:

Coordonnées sur le terrain : x en % de sa largeur (0 : gauche), y en % de sa longueur (0 : le but de l’équipe)

object
x
required
number
<= 100
y
required
number
<= 100
positionLabel
required

Poste du joueur (« Gardien », « Milieu »…), d’après sa carrière dans l’équipe à la date du match ; null si elle ne le dit pas

string
nullable
coach
required
Any of:

Une personne : athlète, joueur, arbitre

object
id
required

Identifiant opaque d’une personne (athlète, arbitre)

string
>= 1 characters
name
required
string
nullable
photo
required
Any of:

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
small
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
large
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
meta
required
object
generatedAt
required

Date de génération de la réponse

string format: date-time
version
required

Version du contrat de la réponse : v1 pour une ressource /v1, celle du module pour un module (/modules/<nom>/v<n> → v<n>)

string
Allowed values: v1
lang
required

Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l’anglais, puis le français.

string
Allowed values: ar da de en es fa fi fr it ja ko nl no pl pt ro ru sv th tr zh
pollAfter
required

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

integer
nullable
links
required
object
self
required

Chemin de la ressource, paramètres triés

string

Example

{
"data": {
"contest": {
"type": "head-to-head",
"home": {
"competitor": {
"type": "team"
}
},
"away": {
"competitor": {
"type": "team"
}
}
},
"actions": [
{
"side": "home"
}
],
"lineups": [
{
"competitor": {
"type": "team"
}
}
]
},
"meta": {
"version": "v1",
"lang": "ar"
}
}

Contenu inchangé depuis l’ETag envoyé en If-None-Match

Paramètre invalide, inconnu ou manquant

Media typeapplication/problem+json

Erreur au format application/problem+json (RFC 9457)

object
type
required
string
title
required
string
status
required
integer
code
required

Code stable d’une erreur de l’API. Liste ouverte : ignorer une valeur inconnue.

string
>= 1 characters
detail

Explication propre à cette requête

string
requestId

Identifiant de la requête (aussi en en-tête X-Request-Id) sur une erreur internal-error, à donner au support

string

Example generated

{
"type": "example",
"title": "example",
"status": 1,
"code": "example",
"detail": "example",
"requestId": "example"
}

Contest inconnu, ou qui n’est pas un duel entre deux équipes

Media typeapplication/problem+json

Erreur au format application/problem+json (RFC 9457)

object
type
required
string
title
required
string
status
required
integer
code
required

Code stable d’une erreur de l’API. Liste ouverte : ignorer une valeur inconnue.

string
>= 1 characters
detail

Explication propre à cette requête

string
requestId

Identifiant de la requête (aussi en en-tête X-Request-Id) sur une erreur internal-error, à donner au support

string

Example generated

{
"type": "example",
"title": "example",
"status": 1,
"code": "example",
"detail": "example",
"requestId": "example"
}