Démonstration Datopian, site non officiel de la Communauté urbaine de Dunkerque

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) : guichets distribution sacs

/data/datasets/guichets-distribution-sacs.json

Rapport de gouvernance : fraîcheur, schémas, licences et données personnelles par jeu, par service et par organisation

/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 : guichets distribution sacs

La table entière en JSON

/data/tables/0256ac56-7995-4bea-bf40-0a7308514f84.json
curl
curl '/data/tables/0256ac56-7995-4bea-bf40-0a7308514f84.json'

Une table avec géométries en GeoJSON : guichets distribution sacs

/data/tables/0256ac56-7995-4bea-bf40-0a7308514f84.geojson

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

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

Catalogue (RDF/XML)

/catalog.xml

Catalogue (JSON-LD)

/catalog.jsonld

Jeux de la Communauté urbaine et de la Ville de Dunkerque (RDF/XML) : ce que data.gouv.fr moissonnerait

/catalog-cud-ville.xml

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.

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: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.