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.
En service, le catalogue tourne sur CKAN : 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) : guichets distribution sacs
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 : guichets distribution sacs
La table entière en JSON
curl '/data/tables/0256ac56-7995-4bea-bf40-0a7308514f84.json'
La table entière en CSV
Une table avec géométries en GeoJSON : guichets distribution sacs
DCAT-AP
Les jeux de cette démonstration 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 de la Communauté urbaine et de la Ville de Dunkerque (RDF/XML) : ce que data.gouv.fr moissonnerait
L’ancienne adresse de l’export DCAT de data.dunkerque-agglo.fr redirige ici.
/api/explore/v2.1/catalog/exports/dcat
Anciennes adresses d’export
Géo2France moissonne chaque jour les 174 jeux par les adresses d’export de l’API Explore. Pour les 71 jeux repris dans cette démonstration, elles redirigent vers ses copies (CSV et GeoJSON identiques en contenu ; le JSON est au format DataStore de CKAN) ; pour les autres, vers le portail actuel :
/api/explore/v2.1/catalog/datasets/guichets-distribution-sacs/exports/csv /api/explore/v2.1/catalog/datasets/guichets-distribution-sacs/exports/json /api/explore/v2.1/catalog/datasets/guichets-distribution-sacs/exports/geojson
Les fichiers statiques et l’API CKAN
Chaque fichier de ce démonstrateur correspond à un appel CKAN ; sur le service CKAN, les appels acceptent aussi filtres, pagination et SQL.
| Fichier de ce démonstrateur | CKAN | Appel sur le service CKAN |
|---|---|---|
| /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?fq=organization:communaute-urbaine-de-dunkerque |
Lecture sans clé et sans limite de quota. En service, l’écriture (publication, mise à jour) passe par un jeton d’API CKAN par service.