Aller au contenu

Fiche d'une personne

GET
/v1/persons/{id}
curl --request GET \
--url 'https://example.com/v1/persons/3098901?lang=ar'

Identité, naissance, nationalités et mensurations d’un athlète, entraîneur ou arbitre. Données de référentiel, cachées un jour.

id
required

Personne (person.id d’un effectif ou d’une composition)

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

Example

3098901

Personne (person.id d’un effectif ou d’une composition)

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.

Fiche de la personne

Media typeapplication/json
object
data
required

Fiche d’une personne : athlète, entraîneur, arbitre

object
id
required

Identifiant opaque d’une personne (athlète, arbitre)

string
>= 1 characters
name
required

Prénom et nom

string
nullable
photo
required
Any of:

Portrait d’une personne, en JPEG au format 5:7 : small en 50 × 70 px (liste, composition), large en 100 × 141 px (fiche). Beaucoup de personnes n’ont pas de portrait : l’adresse répond alors 404, prévoyez un repli (silhouette 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
firstName
required
string
nullable
lastName
required
string
nullable
nickname
required

Nom d’usage s’il diffère (« Neymar »)

string
nullable
gender
required

Sexe tel que la source le classe (catégories masculines et féminines)

string
Allowed values: male female
birthDate
required

Jour calendaire ISO 8601 (2026-10-10)

string format: date
nullable
birthPlace
required
Any of:

Une ville et son pays

object
city
required
string
nullable
country
required
Any of:

Un pays ; code est null si la source n’en a pas

object
id
required

Identifiant opaque d’un pays

string
>= 1 characters
name
required
string
nullable
code
required

Code CIO du pays (FRA) ; à défaut, son code iDalgo (VA)

string
nullable /^[A-Z]{2,3}$/
flag
required
Any of:

Drapeau d’un pays : small en PNG 16 × 11 px, svg vectoriel au format 3:2. Un pays dont iDalgo n’a pas le fichier répond 404 à ces adresses : prévoyez un repli

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

Le drapeau en SVG, au format 3:2, net à toute taille

string format: uri
deathDate
required

Jour calendaire ISO 8601 (2026-10-10)

string format: date
nullable
nationalities
required

Dans l’ordre de la source

Array<object>

Un pays ; code est null si la source n’en a pas

object
id
required

Identifiant opaque d’un pays

string
>= 1 characters
name
required
string
nullable
code
required

Code CIO du pays (FRA) ; à défaut, son code iDalgo (VA)

string
nullable /^[A-Z]{2,3}$/
flag
required
Any of:

Drapeau d’un pays : small en PNG 16 × 11 px, svg vectoriel au format 3:2. Un pays dont iDalgo n’a pas le fichier répond 404 à ces adresses : prévoyez un repli

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

Le drapeau en SVG, au format 3:2, net à toute taille

string format: uri
height
required

Taille en centimètres

integer
nullable
weight
required

Poids en kilogrammes

integer
nullable
website
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": {
"gender": "male"
},
"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"
}

Personne inconnue

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