Aller au contenu

/v1/standings

GET
/v1/standings
curl --request GET \
--url 'https://example.com/v1/standings?season=374703&after=day%3A6865802&split=overall&lang=ar'
season
required

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

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

Example

374703

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

after

Classement après une journée (day:<id>) ; par défaut, la plus récente de chaque poule

string
/^day:\d+$/

Example

day:6865802

Classement après une journée (day:<id>) ; par défaut, la plus récente de chaque poule

split

Classement général, à domicile ou à l’extérieur

string
Allowed values: overall home away

Classement général, à domicile ou à l’extérieur

group

Une seule poule ; par défaut, toutes

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

Une seule poule ; par défaut, toutes

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.

Classement de la saison ; sa forme dépend de kind

Media typeapplication/json
object
data
required
One of: discriminator: kind

Classement aux points

object
kind
required
string
Allowed values: league-table
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
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
split
required

Classement général, à domicile ou à l’extérieur

string
Allowed values: overall home away
columns
required

Clés de stats à afficher, dans l’ordre

Array<string>
Allowed values: points played won drawn lost scored conceded difference
groups
required
Array<object>

Une poule et son classement après day ; id vaut null pour une phase sans poule

object
id
required

Identifiant opaque d’une poule

string
nullable >= 1 characters
name
required
string
nullable
day
required

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
rows
required
Array<object>
object
position
required
integer
evolution
required

Évolution de la place depuis la journée précédente

integer
nullable
competitor
required

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

Classement aux points (football, rugby, handball…). scored / conceded : buts ou points selon le sport.

object
points
required
number
played
required
integer
won
required
integer
drawn
required
integer
lost
required
integer
scored
required
integer
conceded
required
integer
difference
required
integer
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": {
"kind": "league-table",
"split": "overall",
"columns": [
"points"
],
"groups": [
{
"rows": [
{
"competitor": {
"type": "team"
}
}
]
}
]
},
"meta": {
"version": "v1",
"lang": "ar"
}
}

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

Paramètre invalide ou inconnu

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 sans classement

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