Aller au contenu

Score Center (module ScoreCenter v1)

GET
/modules/score-center/v1
curl --request GET \
--url 'https://example.com/modules/score-center/v1?sport=302&date=2026-10-18&status=live&competitions=103%2C2003%2C503&timeZone=Europe%2FParis&lang=ar'

Les matchs d’un sport sur un jour du fuseau du média (Europe/Paris par défaut), groupés par compétition dans l’ordre de competitions (à défaut, la liste par défaut du sport), filtrables par statut. previousDate et nextDate donnent les jours voisins qui ont des matchs : la navigation saute les jours vides. Le classement d’un bloc se lit via /v1/standings?season=.

sport
required

Un sport (id de /v1/sports)

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

Example

302

Un sport (id de /v1/sports)

date

Jour affiché, dans le fuseau timeZone ; par défaut, aujourd’hui

string format: date

Example

2026-10-18

Jour affiché, dans le fuseau timeZone ; par défaut, aujourd’hui

status

Filtre du Score Center : en cours (live), terminés (finished) ou à venir (scheduled) ; sans filtre, tous. Liste fermée : une valeur inconnue est refusée (400).

string
Allowed values: live finished scheduled

Filtre du Score Center : en cours (live), terminés (finished) ou à venir (scheduled) ; sans filtre, tous. Liste fermée : une valeur inconnue est refusée (400).

competitions

Compétitions affichées, dans l’ordre des blocs (30 max) ; par défaut, la liste du sport définie par l’API

string
/^\d+(,\d+){0,29}$/

Example

103,2003,503

Compétitions affichées, dans l’ordre des blocs (30 max) ; par défaut, la liste du sport définie par l’API

timeZone

Fuseau du média (IANA, casse indifférente), qui borne le jour ; par défaut Europe/Paris

string

Example

Europe/Paris

Fuseau du média (IANA, casse indifférente), qui borne le jour ; par défaut Europe/Paris

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.

Widget ScoreCenter en un appel : les matchs du jour groupés par compétition et les jours voisins qui en ont

Media typeapplication/json
object
data
required

Module du Score Center (widget ScoreCenter), v1 : les matchs d’un sport sur un jour, groupés par compétition, et les jours voisins qui en ont.

object
date
required

Jour affiché, dans le fuseau timeZone

string format: date
timeZone
required

Fuseau du jour (nom IANA canonique)

string
previousDate
required

Jour précédent qui a des matchs pour ce sport et ces compétitions (flèche gauche) ; null s’il n’y en a pas

string format: date
nullable
nextDate
required

Jour suivant qui a des matchs pour ce sport et ces compétitions (flèche droite) ; null s’il n’y en a pas

string format: date
nullable
competitions
required

Blocs par compétition, dans l’ordre de competitions= (à défaut, de la liste par défaut du sport) ; vide un jour sans match

Array<object>

Un bloc du Score Center : les matchs du jour d’une compétition. phase et day sont ceux de la plupart de ses matchs (un match en retard garde les siens), pour l’en-tête « Journée 17 » ou le nom de la phase. Le panneau Classement lit season via /v1/standings?season=.

object
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:

La phase d’un bloc et son format : en phase à élimination (knockout), pas de classement à ouvrir

object
id
required

Identifiant opaque d’une phase

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

Structure d’une phase, indépendante du sport : championnat, poules, élimination, course, multi-épreuves, circuit. Liste ouverte : ignorer une valeur inconnue.

string
>= 1 characters
day
required
Any of:

La journée d’un bloc et son rang

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

Rang de la journée dans sa phase (« Journée 17 »)

integer
contests
required

Matchs du bloc, par heure de début

Array
One of: discriminator: type

Un duel : match, combat

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

object
id
required

Identifiant opaque d’un stade ou d’un site

string
>= 1 characters
name
required
string
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
hasMoreContests
required

Vrai si le jour compte plus de matchs que le module n’en renvoie

boolean
meta
required

Méta d’une réponse /v1 ou d’un module

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
links
required
object
self
required

Chemin de la ressource, paramètres triés

string

Example

{
"data": {
"timeZone": "Europe/Paris",
"competitions": [
{
"contests": [
{
"type": "head-to-head",
"home": {
"competitor": {
"type": "team"
}
},
"away": {
"competitor": {
"type": "team"
}
}
}
]
}
]
},
"meta": {
"version": "v1",
"lang": "ar"
}
}

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

Paramètre invalide, inconnu ou manquant, ou competitions absent pour un sport sans liste par défaut

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