API Commune

Cet endpoint renvoie la liste des responsables politiques en exercice pour une commune donnée, à partir de son code INSEE.

Endpoint

GET https://www.elupedia.fr/api/commune/{code}

Paramètres

Paramètre	Requis	Description
`code`	Oui	Code INSEE de la commune (5 chiffres), dans l'URL

Exemple de requête

curl https://www.elupedia.fr/api/commune/33318

Réponse JSON

[
  {
    "url": "https://www.elupedia.fr/elus/franck-raynal",
    "firstName": "Franck",
    "lastName": "Raynal",
    "mandateType": "maire",
    "politicalGroup": "Divers droite"
  },
  {
    "url": "https://www.elupedia.fr/elus/sebastien-saint-pasteur",
    "firstName": "Sébastien",
    "lastName": "Saint-Pasteur",
    "mandateType": "depute",
    "politicalGroup": "Socialistes et apparentés"
  }
]

Les données ci-dessus sont fictives et servent uniquement d'illustration du format de réponse.

Champs de la réponse

Champ	Type	Description
`url`	string	URL de la fiche de l'élu sur Elupedia
`firstName`	string	Prénom
`lastName`	string	Nom de famille
`mandateType`	string	Type de mandat (ex : `maire`, `adjoint au maire`, `conseiller municipal`, `depute`)
`politicalGroup`	string \| null	Groupe politique, si connu

Codes de retour

Code	Signification
`200`	Liste des élus (peut être vide si aucun mandat actif trouvé)
`400`	Code INSEE invalide (doit être 5 chiffres)

Notes

Seuls les mandats en cours (sans date de fin) sont retournés.
La recherche porte sur le commune_code et le parent_commune_code des mandats, couvrant ainsi les communes déléguées et les communes nouvelles.
Le ou les députés de la circonscription sont inclus, identifiés via les résultats des dernières élections législatives de la commune.
La réponse est mise en cache 24 heures côté CDN.

CORS

L'endpoint est accessible en cross-origin sans restriction.