Démonstration Datopian, site non officiel de la Communauté d'Agglomération Pays Basque

Datopian erakustaldia, Euskal Herriko Aglomerazio Elkartearen webgune ez ofiziala (itzulpen automatikoa / traduction automatique, à relire)

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.

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) : RGA2020_epci

/data/datasets/rga2020_epci.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 : RGA2020_epci

La table entière en JSON

/data/tables/264fc8d3-8074-4133-a155-03571ba4b424.json
curl
curl '/data/tables/264fc8d3-8074-4133-a155-03571ba4b424.json'

Une table avec géométries en GeoJSON : RGA2020_epci

/data/tables/264fc8d3-8074-4133-a155-03571ba4b424.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 propres de la CAPB et des communes (RDF/XML) : ce que data.gouv.fr moissonnerait

/catalog-capb.xml

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.

Les fichiers statiques et l’API CKAN
Fichier de ce démonstrateurCKANAppel sur le service CKAN de la PoC
/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?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.