Aller au contenu

Tableau de phase finale (module Bracket v1)

GET
/modules/bracket/v1
curl --request GET \
--url 'https://example.com/modules/bracket/v1?season=374703&phase=512803&lang=ar'

Compose /v1/seasons/{id} (ses phases format: knockout) et /v1/contests?season=&phase= pour chaque tour, de la phase demandée à la finale. Les matchs d’un tour sont regroupés par paire de concurrents en oppositions, placées dans l’ordre de la source (game_order) ; le qualifié est celui qui se retrouve au tour suivant, à défaut le vainqueur au cumul puis aux tirs au but. Football.

season
required

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

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

Example

374703

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

phase
required

Premier tour du tableau : une phase format: knockout de /v1/seasons/{id} (« 1/8 de finale » pour un tableau qui part des 1/8)

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

Example

512803

Premier tour du tableau : une phase format: knockout de /v1/seasons/{id} (« 1/8 de finale » pour un tableau qui part des 1/8)

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 Bracket en un appel : tours, oppositions (aller, retour, cumul, tirs au but), qualifiés et place de chaque opposition

Media typeapplication/json
object
data
required

Module du tableau de phase finale (widget Bracket), v1 : les tours d’une phase à élimination, leurs oppositions (aller, retour, cumul, tirs au but), le qualifié et la place de chaque opposition dans le tableau. Football.

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
sport
required
Any of:

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

Tours du tableau dans l’ordre : la phase demandée, puis chaque phase à élimination qui la suit jusqu’à la finale

Array<object>

Un tour du tableau : sa phase, dont name est le libellé (« 1/8 de finale »)

object
phase
required

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

Oppositions du tour, par position

Array<object>

Une opposition d’un tour : deux concurrents, leurs matchs, le cumul et le qualifié

object
position
required

Place de l’opposition dans son tour, de haut en bas (1 : la première), dans l’ordre de la source

integer
nextPosition
required

position de l’opposition du tour suivant où se retrouve le qualifié : le trait qui relie les deux ; null pour le dernier tour, ou tant que le qualifié n’y figure pas

integer
nullable
sides
required

Les deux concurrents, dans l’ordre d’affichage : celui qui reçoit au premier match d’abord

Array<object>

Un concurrent d’une opposition et ses scores

object
competitor
required
Any of:

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

Son score à chaque match, dans l’ordre de contests, prolongations comprises et tirs au but exclus ; null pour un match qui n’a pas commencé

Array<number>
aggregate
required

Cumul de ses scores sur les matchs commencés ; null tant qu’aucun n’a commencé

number
nullable
shootout
required

Tirs au but réussis quand une séance a départagé l’opposition (à afficher entre parenthèses) ; null sans séance

number
nullable
qualified
required

Vrai pour le qualifié (le vainqueur pour la finale), à afficher en gras ; faux des deux côtés tant que l’opposition n’est pas tranchée

boolean
contests
required

Matchs de l’opposition dans l’ordre chronologique : aller et retour, ou un match unique (finale)

Array<object>
>= 1 items

Un match d’une opposition (aller, retour, ou match unique) ; sa fiche est /v1/contests/{id}

object
id
required

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

string
>= 1 characters
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
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": {
"rounds": [
{
"ties": [
{
"sides": [
{
"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"
}

Saison inconnue (season-not-found), phase hors de la saison (phase-not-found), ou phase qui n’est pas à élimination ou d’un sport sans tableau (bracket-unavailable)

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