Fiche joueur (module PlayerCard v1)
const url = 'https://example.com/modules/player-card/v1?person=3098901&lang=ar';const options = {method: 'GET'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://example.com/modules/player-card/v1?person=3098901&lang=ar'Compose /v1/persons/{id} et /v1/persons/{id}/career.
Parameters
Section intitulée « Parameters »Query Parameters
Section intitulée « Query Parameters »Personne
Example
3098901Personne
Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l’anglais, puis le français.
Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l’anglais, puis le français.
Responses
Section intitulée « Responses »Widget PlayerCard en un appel : identité, engagement en cours et parcours
object
Module de la fiche joueur (widget PlayerCard), v1 : identité, engagement actuel, parcours et stats de la saison en un appel.
object
Fiche d’une personne : athlète, entraîneur, arbitre
object
Identifiant opaque d’une personne (athlète, arbitre)
Prénom et nom
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
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Nom d’usage s’il diffère (« Neymar »)
Sexe tel que la source le classe (catégories masculines et féminines)
Jour calendaire ISO 8601 (2026-10-10)
Une ville et son pays
object
Un pays ; code est null si la source n’en a pas
object
Identifiant opaque d’un pays
Code CIO du pays (FRA) ; à défaut, son code iDalgo (VA)
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
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Le drapeau en SVG, au format 3:2, net à toute taille
Jour calendaire ISO 8601 (2026-10-10)
Dans l’ordre de la source
Un pays ; code est null si la source n’en a pas
object
Identifiant opaque d’un pays
Code CIO du pays (FRA) ; à défaut, son code iDalgo (VA)
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
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Le drapeau en SVG, au format 3:2, net à toute taille
Taille en centimètres
Poids en kilogrammes
Un passage dans une équipe, tel que la source le découpe (en général une ligne par saison)
object
Une équipe
object
Identifiant opaque d’une équipe
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
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
null pour une carrière sans équipe (sport individuel)
Sélection nationale (l’équipe porte le nom de son pays) plutôt qu’un club
Un sport : code pour le rendu, id pour filtrer les autres routes (?sport=)
object
Identifiant opaque d’un sport
Code stable d’un sport, qui choisit son profil de rendu ; other sans profil dédié. Liste ouverte : ignorer une valeur inconnue.
Joueur, ou membre de l’encadrement (entraîneur, dirigeant…) ; function le précise
Fonction telle que la source la nomme (« Joueur », « Entraineur »…)
Poste (« Gardien », « Attaquant »…)
Numéro de maillot
Jour calendaire ISO 8601 (2026-10-10)
null si le départ n’est pas prévu
Le passage en cours le plus récent ; null sans engagement actuel
Du plus récent au plus ancien
Un passage dans une équipe, tel que la source le découpe (en général une ligne par saison)
object
Une équipe
object
Identifiant opaque d’une équipe
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
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
null pour une carrière sans équipe (sport individuel)
Sélection nationale (l’équipe porte le nom de son pays) plutôt qu’un club
Un sport : code pour le rendu, id pour filtrer les autres routes (?sport=)
object
Identifiant opaque d’un sport
Code stable d’un sport, qui choisit son profil de rendu ; other sans profil dédié. Liste ouverte : ignorer une valeur inconnue.
Joueur, ou membre de l’encadrement (entraîneur, dirigeant…) ; function le précise
Fonction telle que la source la nomme (« Joueur », « Entraineur »…)
Poste (« Gardien », « Attaquant »…)
Numéro de maillot
Jour calendaire ISO 8601 (2026-10-10)
null si le départ n’est pas prévu
La dernière saison où le joueur a joué, toutes compétitions
object
Saison (« 2026/2027 »)
Toutes compétitions confondues
object
Les statistiques d’un joueur sur une saison, tirées des compositions et des actions de match
object
Matchs joués : titulaire, ou entré en jeu
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)
Titularisations
Matchs commencés sur le banc, entré en jeu ou non
Entrées en jeu
Sorties en cours de match (remplacé)
Buts, hors contre son camp et buts refusés
Dont buts sur penalty
Rouges directs et deuxièmes jaunes
Toutes compétitions ; null si l’une d’elles n’a pas ses stats
Bilan des matchs terminés joués par le joueur, du point de vue de son équipe
object
Matchs terminés que le joueur a joués
La compétition où il a le plus joué d’abord
Une compétition de la saison du joueur : ses stats, son bilan et ses matchs
object
Une compétition (Ligue 1, NBA, Jeux olympiques…)
object
Identifiant opaque d’une compétition
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
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une saison de compétition (« Ligue 1 2026/2027 »)
object
Identifiant opaque d’une saison de compétition
Une équipe
object
Identifiant opaque d’une équipe
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
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Équipe du joueur à son dernier match de la compétition
Les statistiques d’un joueur sur une saison, tirées des compositions et des actions de match
object
Matchs joués : titulaire, ou entré en jeu
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)
Titularisations
Matchs commencés sur le banc, entré en jeu ou non
Entrées en jeu
Sorties en cours de match (remplacé)
Buts, hors contre son camp et buts refusés
Dont buts sur penalty
Rouges directs et deuxièmes jaunes
null si les actions de match de la saison sont incomplètes (import partiel de la source)
Bilan des matchs terminés joués par le joueur, du point de vue de son équipe
object
Matchs terminés que le joueur a joués
Matchs joués par le joueur, du plus récent au plus ancien
Un duel : match, combat
object
Identifiant opaque d’un contest (match, course, épreuve)
Un sport : code pour le rendu, id pour filtrer les autres routes (?sport=)
object
Identifiant opaque d’un sport
Code stable d’un sport, qui choisit son profil de rendu ; other sans profil dédié. Liste ouverte : ignorer une valeur inconnue.
Une compétition (Ligue 1, NBA, Jeux olympiques…)
object
Identifiant opaque d’une compétition
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
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une saison de compétition (« Ligue 1 2026/2027 »)
object
Identifiant opaque d’une saison de compétition
Instant ISO 8601 en UTC (2026-10-10T13:30:00.000Z)
Statut normalisé ; statusLabel donne le libellé exact de la source (« Mi-temps », « Manche 3 »…). Liste ouverte : ignorer une valeur inconnue.
Un camp d’un duel et son score principal
object
Une équipe
object
Identifiant opaque d’une équipe
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
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Un athlète seul
object
Identifiant opaque d’une personne (athlète, arbitre)
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
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Plusieurs athlètes sans équipe (relais, double) ; name réunit leurs noms
object
Identifiant opaque d’un équipage (relais, double)
Une personne : athlète, joueur, arbitre
object
Identifiant opaque d’une personne (athlète, arbitre)
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
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
null tant que le contest n’a pas commencé
Un camp d’un duel et son score principal
object
Une équipe
object
Identifiant opaque d’une équipe
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
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Un athlète seul
object
Identifiant opaque d’une personne (athlète, arbitre)
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
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Plusieurs athlètes sans équipe (relais, double) ; name réunit leurs noms
object
Identifiant opaque d’un équipage (relais, double)
Une personne : athlète, joueur, arbitre
object
Identifiant opaque d’une personne (athlète, arbitre)
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
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
null tant que le contest n’a pas commencé
Une épreuve classée : course, concours. Dans une liste, entries ne contient que le podium ; entryCount compte tous les concurrents.
object
Identifiant opaque d’un contest (match, course, épreuve)
Un sport : code pour le rendu, id pour filtrer les autres routes (?sport=)
object
Identifiant opaque d’un sport
Code stable d’un sport, qui choisit son profil de rendu ; other sans profil dédié. Liste ouverte : ignorer une valeur inconnue.
Une compétition (Ligue 1, NBA, Jeux olympiques…)
object
Identifiant opaque d’une compétition
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
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une saison de compétition (« Ligue 1 2026/2027 »)
object
Identifiant opaque d’une saison de compétition
Instant ISO 8601 en UTC (2026-10-10T13:30:00.000Z)
Statut normalisé ; statusLabel donne le libellé exact de la source (« Mi-temps », « Manche 3 »…). Liste ouverte : ignorer une valeur inconnue.
Un concurrent d’une épreuve classée ; position vaut null pour un non classé
object
Une équipe
object
Identifiant opaque d’une équipe
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
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Un athlète seul
object
Identifiant opaque d’une personne (athlète, arbitre)
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
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Plusieurs athlètes sans équipe (relais, double) ; name réunit leurs noms
object
Identifiant opaque d’un équipage (relais, double)
Une personne : athlète, joueur, arbitre
object
Identifiant opaque d’une personne (athlète, arbitre)
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
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Dernière saison où le joueur a joué ; null sans aucun match connu
Méta d’une réponse /v1 ou d’un module
object
Date de génération de la réponse
Version du contrat de la réponse : v1 pour une ressource /v1, celle du module pour un module (/modules/<nom>/v<n> → v<n>)
Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l’anglais, puis le français.
object
Chemin de la ressource, paramètres triés
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
Erreur au format application/problem+json (RFC 9457)
object
Code stable d’une erreur de l’API. Liste ouverte : ignorer une valeur inconnue.
Explication propre à cette requête
Identifiant de la requête (aussi en en-tête X-Request-Id) sur une erreur internal-error, à donner au support
Example generated
{ "type": "example", "title": "example", "status": 1, "code": "example", "detail": "example", "requestId": "example"}Personne inconnue
Erreur au format application/problem+json (RFC 9457)
object
Code stable d’une erreur de l’API. Liste ouverte : ignorer une valeur inconnue.
Explication propre à cette requête
Identifiant de la requête (aussi en en-tête X-Request-Id) sur une erreur internal-error, à donner au support
Example generated
{ "type": "example", "title": "example", "status": 1, "code": "example", "detail": "example", "requestId": "example"}