Aller au contenu

Fiche joueur (module PlayerCard v1)

GET
/modules/player-card/v1
curl --request GET \
--url 'https://example.com/modules/player-card/v1?person=3098901&lang=ar'

Compose /v1/persons/{id} et /v1/persons/{id}/career.

person
required

Personne

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

Example

3098901

Personne

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.

Widget PlayerCard en un appel : identité, engagement en cours et parcours

Media typeapplication/json
object
data
required

Module de la fiche joueur (widget PlayerCard), v1 : identité, engagement actuel, parcours et stats de la saison en un appel.

object
person
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
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
career
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
latestSeason
required
Any of:

La dernière saison où le joueur a joué, toutes compétitions

object
name
required

Saison (« 2026/2027 »)

string
nullable
total
required

Toutes compétitions confondues

object
stats
required
Any of:

Les statistiques d’un joueur sur une saison, tirées des compositions et des actions de match

object
appearances
required

Matchs joués : titulaire, ou entré en jeu

integer
minutesPlayed
required

Minutes jouées, du coup d’envoi ou de l’entrée en jeu jusqu’à la sortie, l’expulsion ou la 90e (hors temps additionnel et prolongations)

integer
starts
required

Titularisations

integer
benches
required

Matchs commencés sur le banc, entré en jeu ou non

integer
subbedIn
required

Entrées en jeu

integer
subbedOut
required

Sorties en cours de match (remplacé)

integer
goals
required

Buts, hors contre son camp et buts refusés

integer
penaltyGoals
required

Dont buts sur penalty

integer
assists
required
integer
yellowCards
required
integer
redCards
required

Rouges directs et deuxièmes jaunes

integer
record
required

Bilan des matchs terminés joués par le joueur, du point de vue de son équipe

object
played
required

Matchs terminés que le joueur a joués

integer
wins
required
integer
draws
required
integer
losses
required
integer
competitions
required

La compétition où il a le plus joué d’abord

Array<object>

Une compétition de la saison du joueur : ses stats, son bilan et ses matchs

object
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
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
stats
required
Any of:

Les statistiques d’un joueur sur une saison, tirées des compositions et des actions de match

object
appearances
required

Matchs joués : titulaire, ou entré en jeu

integer
minutesPlayed
required

Minutes jouées, du coup d’envoi ou de l’entrée en jeu jusqu’à la sortie, l’expulsion ou la 90e (hors temps additionnel et prolongations)

integer
starts
required

Titularisations

integer
benches
required

Matchs commencés sur le banc, entré en jeu ou non

integer
subbedIn
required

Entrées en jeu

integer
subbedOut
required

Sorties en cours de match (remplacé)

integer
goals
required

Buts, hors contre son camp et buts refusés

integer
penaltyGoals
required

Dont buts sur penalty

integer
assists
required
integer
yellowCards
required
integer
redCards
required

Rouges directs et deuxièmes jaunes

integer
record
required

Bilan des matchs terminés joués par le joueur, du point de vue de son équipe

object
played
required

Matchs terminés que le joueur a joués

integer
wins
required
integer
draws
required
integer
losses
required
integer
contests
required

Matchs joués par le joueur, du plus récent au plus ancien

Array
One of: discriminator: type

Un duel : match, combat

object
type
required
string
Allowed values: head-to-head
id
required

Identifiant opaque d’un contest (match, course, épreuve)

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

Une phase de la saison (saison régulière, play-offs…)

object
id
required

Identifiant opaque d’une phase

string
>= 1 characters
name
required
string
nullable
group
required
Any of:

Une poule d’une phase

object
id
required

Identifiant opaque d’une poule

string
>= 1 characters
name
required
string
nullable
day
required
Any of:

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

Instant ISO 8601 en UTC (2026-10-10T13:30:00.000Z)

string format: date-time
nullable
status
required

Statut normalisé ; statusLabel donne le libellé exact de la source (« Mi-temps », « Manche 3 »…). Liste ouverte : ignorer une valeur inconnue.

string
>= 1 characters
statusLabel
required
string
nullable
venue
required
Any of:

Un stade ou un site

object
id
required

Identifiant opaque d’un stade ou d’un site

string
>= 1 characters
name
required
string
nullable
home
required

Un camp d’un duel et son score principal

object
competitor
required
One of: discriminator: type

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

null tant que le contest n’a pas commencé

number
nullable
away
required

Un camp d’un duel et son score principal

object
competitor
required
One of: discriminator: type

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

null tant que le contest n’a pas commencé

number
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": {
"person": {
"gender": "male"
},
"current": {
"team": {
"type": "team"
},
"role": "player"
},
"career": [
{
"team": {
"type": "team"
},
"role": "player"
}
],
"latestSeason": {
"competitions": [
{
"team": {
"type": "team"
},
"contests": [
{
"type": "head-to-head",
"home": {
"competitor": {
"type": "team"
}
},
"away": {
"competitor": {
"type": "team"
}
}
}
]
}
]
}
},
"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"
}

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