Démonstrateur réalisé par Datopian · ce n’est pas un site officiel de la Ville de Cannes · données issues de data.cannes.com et de sources publiques nationales

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.

docs.ckan.org/en/2.11/api

Le catalogue

Tous les jeux : titre, description, thèmes, formats, service

/data/search.json
curl
curl '/data/search.json'

Producteurs (format CKAN organization_list)

/data/organizations.json

Thèmes (format CKAN group_list)

/data/groups.json

Les métadonnées d’un jeu (format CKAN package_show) : Délibérations

/data/datasets/deliberations.json

Rapport de gouvernance : fraîcheur, schémas et métadonnées par jeu et par service

/data/quality.json

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

/data/tables/ecd9c5ef-0a4b-4e96-9f32-d581245ff327.json
curl
curl '/data/tables/ecd9c5ef-0a4b-4e96-9f32-d581245ff327.json'

Une table avec géométries en GeoJSON : Equipements publics cannois

/data/tables/143155fd-6074-47c9-b95a-dede97fb6b47.geojson

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 (Turtle)

/catalog.ttl
curl
curl '/catalog.ttl'

Catalogue (RDF/XML)

/catalog.xml

Catalogue (JSON-LD)

/catalog.jsonld

Jeux de la Ville de Cannes seulement (RDF/XML)

/catalog-ville-de-cannes.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.

Les fichiers statiques et l’API CKAN
Fichier de ce démonstrateurCKANAppel sur le service CKAN
/data/search.jsonpackage_search/api/3/action/package_search?q=…&fq=groups:finances
/data/datasets/<name>.jsonpackage_show/api/3/action/package_show?id=<name>
/data/organizations.jsonorganization_list/api/3/action/organization_list?all_fields=true
/data/groups.jsongroup_list/api/3/action/group_list?all_fields=true
/data/tables/<id>.jsondatastore_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, .jsonldckanext-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.