API Statut sportif de haut niveau et sur liste ministérielle prochainement
Statut sportif de haut niveau et toute catégorie inscrits en liste des collectifs nationaux ou en liste des arbitres et juges sportifs de haut-niveau.
Cette API est bientôt disponible, testez-là !
Cette API est en cours de conception et va bientôt rejoindre le catalogue d'API Particulier.
En plus de cette documentation, un environnement technique de test est déjà disponible : Consulter le swagger
Sport Data Hub
Périmètre
Particuliers concernés :
Cette API concerne tous les sportifs de nationalité française ou étrangère dont le statut, reconnu par le ministère des sports, est le suivant :
- ✅ les sportifs sur liste ministérielle : sportif de haut niveau (SHN), sportif inscrit en liste Espoirs (SE), sportif inscrit en liste des Collectifs Nationaux (SCN) ;
- ✅ les sportifs du parcours de performance fédéral (PPF) ;
- ✅ les arbitre-juge de haut niveau (AJSHN).
Plus d’informations sur les différents statuts et catégories des sportifs reconnu par le minstère des sports
L’API couvre les sportifs de tout âge, y compris les mineurs.
Périmètre géographique :
- ✅ France métropolitaine
- ✅ DROM COM
Actualisation de la donnée :
Les données sont mises à jour une fois par an, selon la saison sportive :
- Sports d’hiver : du 1er juillet de l’année N au 30 juin de l’année N+1 ;
- Sports d’été : du 1er janvier au 31 décembre.
Les données sont valables un an, sur l’année scolaire en général, sauf le statut du sportif de haut niveau de la catégorie élite qui est valable 2 ans.
⚠️ En conséquence, un sportif qui a concouru en novembre 2024 pour les sports d’hiver et qui est devenu sportif de haut niveau à cette période n’apparaîtra dans l’API qu’à partir de juillet 2025. Un statut demandé à un instant T peut donc être différent à un instant T+ en fonction des mises à jour. Les informations obtenues sont représentatives de la situation connue par Sport Data Hub au moment de l’appel.
Spécifications de l'API
Format de l'information
Modalité d'appel
- Identifiant PSQS
Disponibilité
Page de statut des APISpécifications techniques :
Consulter le swagger Cas de testsModalités d'appel
Cette API propose une modalités d’appel :
Identifiant PSQS
Avec l’identifiant du portail de suivi quotidien du sportif (PSQS).
Les données
Cette API délivre :
- le statut actuel du sportif ou de l’arbitre-juge (actif/inactif) ;
- la catégorie du sportif (espoir, relève, élite, senior, reconversion, collectif national, arbitre-juge, parcours de performance fédéral) ;
- les informations du club (nom, localisation, affiliation) ;
- l’historique du statut (précédents statuts, catégories, clubs etc.). Les données historiques remontent à 1994 pour les listes ministerielles et à partir de 2012 pour les sportifs du PPF. Ce n’est qu’à partir de 2017 que tous les sportifs du PPF ont été intégrés.
Informations renvoyées en JSON :
Questions & réponses
Sportifs de haut niveau (SHN). Ils sont inscrits sur la Liste des Sportifs de Haut Niveau (SHN) publiée par le ministère, et sont répartis en plusieurs sous-catégories :
Élite : Athlètes ayant obtenu des résultats exceptionnels au niveau international (Jeux Olympiques, Championnats du monde…).
Sénior : Sportifs en équipe nationale avec un potentiel pour des compétitions internationales.
Relève : Jeunes sportifs avec un fort potentiel pour accéder au plus haut niveau.
Reconversion : |
Anciens sportifs de haut niveau bénéficiant d’un accompagnement pour leur transition professionnelle.
Sportifs Espoirs : Jeunes talents identifiés comme prometteurs par leur fédération, mais n’ayant pas encore atteint le niveau international.
Sportifs des Collectifs Nationaux : Athlètes appartenant aux équipes nationales dans certaines disciplines spécifiques.
Sportifs du parcours de performance fédéral : Le Parcours de Performance Fédéral (PPF) est un programme structuré permettant d’identifier et d’accompagner les jeunes talents jusqu’au haut niveau. Ces jeunes ne sont pas encore sur liste ministérielle.
Arbitres et juges de haut niveau : Officiels qui assurent le bon déroulement des compétitions en appliquant les règles du sport concerné. Ils peuvent être :
Arbitres (sports collectifs : football, basket, rugby, handball, etc.)
Juges (sports notés : gymnastique, patinage, natation artistique, etc.)
Officiels techniques (athlétisme, escrime, haltérophilie, etc.)
Conditions d'utilisation des données
Ouverture de la donnée :
Conditions spécifiques à cette API :
Les conditions d’utilisations spécifiques à l’API
Conditions générales :
Cette API et l’utilisation de ses données est soumise aux CGU générales d’API Particulier, dont voici les principaux éléments auxquels vous vous engagez :
- ne demander que les données strictement nécessaires ;
- ne pas utiliser votre jeton d’accès pour une démarche différente de celle indiquée lors de votre demande (le cas échéant le jeton sera révoqué) ;
- présenter les données obtenues uniquement aux seuls agents habilités et à tracer l’accès de ces agents aux données ;
- ne pas commercialiser les données reçues et à ne pas les communiquer à des tiers en dehors des cas prévus par la loi.
CGU API Particulier
Spécifications de l'API
Format de l'information
Modalité d'appel
- Identifiant PSQS