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.
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) : Lycées d'Occitanie année scolaire 2025-2026
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 : Lycées d'Occitanie année scolaire 2025-2026
La table entière en JSON
curl '/data/tables/7c36da85-6882-4144-be56-3b1200d256f4.json'
La table entière en CSV
Une table avec géométries en GeoJSON : Lycées d'Occitanie année scolaire 2025-2026
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 propres de la Région, des membres et de leurs partenaires (RDF/XML) : le flux que data.gouv.fr moissonnerait
Un seul flux pour les huit portails, partenaires compris, 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.
| Fichier de ce démonstrateur | CKAN | Appel sur le service CKAN de la PoC |
|---|---|---|
| /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?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.