Aller au contenu

/v1/seasons

GET
/v1/seasons
curl --request GET \
--url 'https://example.com/v1/seasons?competition=103&lang=ar'
competition
required

Une compétition (id de /v1/competitions)

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

Example

103

Une compétition (id de /v1/competitions)

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.

Saisons de la compétition, de la plus récente à la plus ancienne (non paginé)

Media typeapplication/json

Saisons d’une compétition, de la plus récente à la plus ancienne. Liste bornée : non paginée.

object
data
required
Array<object>

Une saison dans la liste de sa compétition

object
id
required

Identifiant opaque d’une saison de compétition

string
>= 1 characters
name
required
string
year
required

Année de fin de saison

integer
nullable
current
required

Saison courante de la compétition

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

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