API et développeurs
Ce démonstrateur est un site statique : le catalogue, chaque table et les métadonnées sont publiés en fichiers, aux formats de CKAN et DCAT-AP. Sans clé, CORS ouvert.
Derrière ce site, le catalogue tourne sur le service CKAN de la PoC (CKAN 2.11) : les mêmes données sont servies par l’API Action standard de CKAN, avec recherche, filtres et SQL sur les tables ; les clients CKAN existants et le moissonneur de data.gouv.fr fonctionnent sans changement.
Le catalogue
Tous les jeux : titre, description, thèmes, formats, service
curl '/data/search.json'
Producteurs (format CKAN organization_list)
Thèmes (format CKAN group_list)
Les métadonnées d’un jeu (format CKAN package_show) : RGA2020_epci
Rapport de gouvernance : fraîcheur, schémas, licences et données personnelles par jeu, par service et par organisation
Les tables
Chaque table est un fichier JSON (format DataStore de CKAN : colonnes puis lignes), un CSV et, avec des géométries, un GeoJSON. Exemple : RGA2020_epci
La table entière en JSON
curl '/data/tables/264fc8d3-8074-4133-a155-03571ba4b424.json'
La table entière en CSV
Une table avec géométries en GeoJSON : RGA2020_epci
DCAT-AP
Tout le catalogue en DCAT-AP 3 (ckanext-dcat), avec les URI européennes de fréquence et de licence et les catégories de données de forte valeur. Chaque fiche donne aussi son propre enregistrement DCAT.
Catalogue (RDF/XML)
Catalogue (JSON-LD)
Jeux propres de la CAPB et des communes (RDF/XML) : ce que data.gouv.fr moissonnerait
Sans les copies de jeux nationaux, qui restent publiées par leur producteur d’origine.
Les fichiers statiques et l’API CKAN
Chaque fichier de ce démonstrateur correspond à un appel sur le service CKAN de la PoC, qui accepte aussi filtres, pagination et SQL.
| Fichier de ce démonstrateur | CKAN | Appel sur le service CKAN de la PoC |
|---|---|---|
| /data/search.json | package_search | /api/3/action/package_search?q=…&fq=groups:finances |
| /data/datasets/<name>.json | package_show | /api/3/action/package_show?id=<name> |
| /data/organizations.json | organization_list | /api/3/action/organization_list?all_fields=true |
| /data/groups.json | group_list | /api/3/action/group_list?all_fields=true |
| /data/tables/<id>.json | datastore_search | /api/3/action/datastore_search?resource_id=<id>&filters={…}&q=… |
| — | datastore_search_sql | /api/3/action/datastore_search_sql?sql=SELECT … FROM "<id>" |
| /data/tables/<id>.csv | /datastore/dump | /datastore/dump/<id>?format=csv|json|tsv|xlsx |
| /catalog.ttl, .xml, .jsonld | ckanext-dcat | /catalog.ttl?q=…&fq=organization:<organisation> |
Lecture sans clé et sans limite de quota. L’écriture (publication, mise à jour) passe par un jeton d’API CKAN par producteur.