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) : Délibérations
Rapport de gouvernance : fraîcheur, schémas et métadonnées par jeu et par service
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 : Délibérations
La table entière en JSON
curl '/data/tables/ecd9c5ef-0a4b-4e96-9f32-d581245ff327.json'
La table entière en CSV
Une table avec géométries en GeoJSON : Equipements publics cannois
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 de la Ville de Cannes seulement (RDF/XML)
L’ancienne adresse de l’export DCAT de data.cannes.com, moissonnée chaque jour par data.gouv.fr, redirige ici : le moissonnage continue de fonctionner.
/api/explore/v2.1/catalog/exports/dcat/?where=…
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:ville-de-cannes |
Lecture sans clé. En service, l’écriture (publication, mise à jour) passe par un jeton d’API CKAN par service.