Fiches collectivités

Tableau de bord sur les dotations aux collectivités, en PDF, en JSON ou en web components à intégrer dans une autre application.

Une fiche se demande par code INSEE de commune ou par SIREN de commune ou de groupement. Exemples : Rennes (PDF, JSON), Rennes Métropole, Ahaxe-Alciette-Bascassan.

Endpoints

Endpoint	Rôle
`GET /fiches/{identifiant}.html`	la fiche en page web
`GET /fiches/{identifiant}.pdf`	la fiche en PDF
`GET /fiches/{identifiant}.json`	les données de tous les composants
`GET /fiches/{identifiant}/{composant}.json`	les données d'un composant
`GET /fiches/{identifiant}/{composant}.html`	un composant seul, en page web
`GET /fiches/{identifiant}/{composant}/{fichier}`	un fichier produit par un composant, le GeoJSON des cartes par exemple
`GET /components`	la liste des composants, en JSON

?component=a,b restreint une fiche entière (HTML, PDF, JSON) aux composants choisis. Chaque valeur affichée figure dans le JSON en {"value": …, "label": …} : la valeur brute et son libellé formaté. Le détail des paramètres et des réponses est dans la documentation OpenAPI.

Composants

Nom	Contenu	Largeur
`identite`	Identité de la collectivité : SIREN, code INSEE, population, superficie, densité, codes postaux, intercommunalité, département, région.	1/2
`programmes`	Programmes nationaux dont relève la commune : Action cœur de ville, Petites villes de demain, Territoires d'industrie, Villages d'avenir.	1/2
`carto`	Cartes du département et de l'intercommunalité de la commune, colorées par taux de financement.	1
`chiffres`	Financements reçus : totaux par dispositif, montants des cinq dernières années révolues, répartition par financeur.	1
`historique`	Liste des financements reçus, projet par projet, avec leur coût et leur taux de financement.	1
`competences`	Compétences exercées par un groupement, selon la nomenclature Banatic.	1

Intégrer un composant

Chaque composant est un web component qui charge lui-même son JSON. Pour l'intégrer dans une autre application :

charger dans la page le CSS du DSFR et fico.css : les composants n'apportent pas leurs styles ;
importer le module du composant et placer son élément, comme ci-dessous.

<link rel="stylesheet" href="https://fico.example/assets/fico.css">
<script type="module" src="https://fico.example/assets/components/identite.js"></script>
<fico-identite src="https://fico.example/fiches/35238/identite.json"></fico-identite>

Pour une fiche entière, <fico-fiche> charge les composants choisis en un seul appel et les dispose comme le PDF : deux composants étroits qui se suivent partagent une ligne, un composant sans données disparaît.

<script type="module" src="https://fico.example/assets/fiche.js"></script>
<fico-fiche src="https://fico.example/fiches/35238.json?component=identite,programmes,historique"></fico-fiche>