Aller au contenu

Liste de matchs en direct (module MatchList v1)

GET
/modules/match-list/v1/live
curl --request GET \
--url 'https://example.com/modules/match-list/v1/live?season=374703&day=10657303&lang=ar'

Relue par le widget pour chaque journée affichée, tant que meta.pollAfter n’est pas null : les matchs de la journée dans l’ordre du module, au format des vues /v1/live. 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.

season
required

Une saison (currentSeason.id de /v1/competitions)

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

Example

374703

Une saison (currentSeason.id de /v1/competitions)

day
required

Journée relue

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

Example

10657303

Journée relue

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.

Les matchs d’une journée réduits à ce qui bouge (statut, score, heure). meta.pollAfter : secondes avant la prochaine lecture, null quand plus rien ne bougera.

Media typeapplication/json
object
data
required

Ce qui bouge sur une journée de la liste de matchs pendant qu’elle se joue, au format des vues /v1/live.

object
contests
required

Contests de la journée réduits à ce qui bouge (statut, score, heure), dans l’ordre du module : le widget les reporte sur ses cartes par id

Array
One of: discriminator: type

Duel en direct

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

Un camp d’un duel en direct : la part de ContestSide qui bouge

object
score
required

Score principal ; null tant que le match n’a pas commencé

number
nullable
away
required

Un camp d’un duel en direct : la part de ContestSide qui bouge

object
score
required

Score principal ; null tant que le match n’a pas commencé

number
nullable
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": {
"contests": [
{
"type": "head-to-head"
}
]
},
"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"
}

Saison inconnue, ou journée hors de la saison

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"
}