Aller au contenu

/v1/sports

GET
/v1/sports
curl --request GET \
--url 'https://example.com/v1/sports?limit=20&lang=ar'
cursor

Curseur de la page suivante, tel que renvoyé dans meta.cursor

string

Curseur de la page suivante, tel que renvoyé dans meta.cursor

limit

Taille de la page, de 1 à 100 (défaut : 20)

integer
>= 1 <= 100

Example

20

Taille de la page, de 1 à 100 (défaut : 20)

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.

Sports, triés par id ; id sert de filtre sport aux autres routes

Media typeapplication/json
object
data
required
Array<object>

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

Méta d’une liste paginée par curseur

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

Curseur à renvoyer en ?cursor= pour la page suivante ; null sur la dernière

string
nullable
links
required
object
self
required

Chemin de la ressource, paramètres triés

string
next

Page suivante ; absent sur la dernière

string

Example

{
"meta": {
"version": "v1",
"lang": "ar"
}
}

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

Paramètre invalide ou inconnu, ou curseur invalide

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