Feuille de route
Endpoints prévus, avec leur spécification cible. Ils suivront les mêmes conventions que l'API actuelle : JSON, dates ISO, identifiants stables, licence ODbL, clés et quotas partagés. Ton besoin déborde de ce cadre ? Écris-nous via le formulaire de contact du site principal.
GET /v1/elus/{id}/equipe — équipe actuelle d'un élu
La composition actuelle de l'équipe parlementaire d'un élu, à partir des affectations en cours.
{
"elu": {
"id": "PA795076", "nom": "Julien DIVE", "chambre": "assemblee", "groupe": "LR"
},
"collaborateurs": [
{
"cle": "petit_theo", "nom": "PETIT", "prenom": "Théo", "civilite": "M.",
"fonction": "Chef de cabinet", "depuis": "2024-07-01"
}
],
"licence": "ODbL 1.0",
"attribution": "DataParl' (dataparl.fr), d'après les publications de l'Assemblée nationale et du Sénat"
}GET /v1/collaborateurs/{cle} — parcours d'un collaborateur
Tous les mouvements d'un collaborateur, du plus récent au plus ancien : son parcours complet entre élus et chambres. cle est la clé normalisée (sans accents) déjà présente dans les réponses de /v1/mouvements (champ collab_cle).
{
"collaborateur": { "cle": "petit_theo", "nom": "PETIT", "prenom": "Théo" },
"total": 4,
"mouvements": [
{
"id": "3f9c2a71b0d4e8a1", "date_event": "2026-10-10", "chambre": "assemblee",
"type": "arrivee", "elu_nom": "Julien DIVE", "elu_groupe": "LR", "fonction": "Assistant parlementaire"
}
],
"licence": "ODbL 1.0"
}GET /v1/mouvements/stats — agrégats
Séries agrégées par mois et par chambre ou groupe : arrivées, départs, transferts. Évite de télécharger toute l'histoire pour un simple indicateur de turnover.
{
"granularite": "mois",
"depuis": "2026-01-01", "jusqua": "2026-10-10",
"serie": [
{ "mois": "2026-09", "chambre": "assemblee", "arrivees": 142, "departs": 96, "transferts": 18 },
{ "mois": "2026-09", "chambre": "senat", "arrivees": 21, "departs": 14, "transferts": 3 }
],
"licence": "ODbL 1.0"
}Filtres prévus : chambre, groupe, depuis, jusqua, granularite=mois|annee.
GET /v1/groupes — harmonisation des groupes
Référentiel des groupes par chambre, avec les renommages au fil du temps (ex. FN → RN, ALDE → Renew), pour interpréter elu_groupe dans les séries longues.
{
"groupes": [
{ "chambre": "assemblee", "code": "RN", "nom": "Rassemblement National",
"precedents": [{ "code": "FN", "jusqua": "2018-06-01" }] }
],
"licence": "ODbL 1.0"
}Priorités
- Équipes d'élus (
/v1/elus/{id}/equipe) - Parcours collaborateur (
/v1/collaborateurs/{cle}) - Agrégats (
/v1/mouvements/stats) - Référentiel groupes (
/v1/groupes) - Export bulk périodique (CSV/Parquet) annoncé sur data.gouv.fr