Aller au contenu

Parcours d'une personne

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

Chaque passage dans une équipe tel que la source le découpe (en général une ligne par saison), toutes équipes et tous sports, avec current pour l’engagement en cours.

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.

Parcours de la personne, du plus récent au plus ancien

Media typeapplication/json
object
data
required

Parcours d’une personne, toutes équipes et tous sports

object
person
required

Une personne : athlète, joueur, arbitre

object
id
required

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

string
>= 1 characters
name
required
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
current
required
Any of:

Un passage dans une équipe, tel que la source le découpe (en général une ligne par saison)

object
team
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
national
required

Sélection nationale (l’équipe porte le nom de son pays) plutôt qu’un club

boolean
sport
required

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

Joueur, ou membre de l’encadrement (entraîneur, dirigeant…) ; function le précise

string
Allowed values: player staff
function
required

Fonction telle que la source la nomme (« Joueur », « Entraineur »…)

string
nullable
position
required

Poste (« Gardien », « Attaquant »…)

string
nullable
shirt
required

Numéro de maillot

integer
nullable
from
required

Jour calendaire ISO 8601 (2026-10-10)

string format: date
nullable
until
required

null si le départ n’est pas prévu

string format: date
nullable
spells
required

Les séjours, du plus récent au plus ancien : le parcours résumé

Array<object>

Un séjour dans une équipe : ses passages consécutifs dans le même rôle, regroupés (Monaco 2015-2017, puis Paris SG 2017-2024…)

object
team
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
national
required

Sélection nationale (l’équipe porte le nom de son pays) plutôt qu’un club

boolean
sport
required

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

Joueur, ou membre de l’encadrement (entraîneur, dirigeant…) ; function le précise

string
Allowed values: player staff
function
required

Fonction du passage le plus récent

string
nullable
position
required

Poste du passage le plus récent

string
nullable
from
required

Jour calendaire ISO 8601 (2026-10-10)

string format: date
nullable
until
required

null si le départ n’est pas prévu

string format: date
nullable
entries
required

Du plus récent au plus ancien

Array<object>

Un passage dans une équipe, tel que la source le découpe (en général une ligne par saison)

object
team
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
national
required

Sélection nationale (l’équipe porte le nom de son pays) plutôt qu’un club

boolean
sport
required

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

Joueur, ou membre de l’encadrement (entraîneur, dirigeant…) ; function le précise

string
Allowed values: player staff
function
required

Fonction telle que la source la nomme (« Joueur », « Entraineur »…)

string
nullable
position
required

Poste (« Gardien », « Attaquant »…)

string
nullable
shirt
required

Numéro de maillot

integer
nullable
from
required

Jour calendaire ISO 8601 (2026-10-10)

string format: date
nullable
until
required

null si le départ n’est pas prévu

string format: date
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": {
"current": {
"team": {
"type": "team"
},
"role": "player"
},
"spells": [
{
"team": {
"type": "team"
},
"role": "player"
}
],
"entries": [
{
"team": {
"type": "team"
},
"role": "player"
}
]
},
"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"
}