API & moissonnage
Toutes les données et métadonnées du portail sont accessibles par une API REST documentée, en JSON, sans authentification pour la lecture. Le catalogue est exposé au format DCAT pour le moissonnage par data.gouv.fr et par la plateforme régionale de la donnée.
Démonstration. Ce portail est un démonstrateur statique : les réponses ci-dessous sont générées localement à partir des données réellement embarquées dans le portail — leur contenu correspond exactement à ce que renverrait l'API en production.
Points d'accès
Le tableau défile horizontalement sur petit écran.
| Méthode et chemin | Description | Paramètres |
|---|---|---|
GET /api/1/catalogue | Liste des jeux de données et de leurs métadonnées | theme, format, q (recherche), limit, offset |
GET /api/1/jeux/{id} | Métadonnées complètes d'un jeu | — |
GET /api/1/jeux/{id}/donnees | Enregistrements du jeu, en JSON | limit, offset, tri |
GET /api/1/jeux/{id}/telecharger.{csv|json|geojson} | Ressource complète dans le format demandé | — |
GET /api/1/dcat | Catalogue complet au format DCAT (JSON-LD), pour moissonnage | — |
Réponses en UTF-8 (application/json), codes HTTP standard (200, 400, 404, 500),
pagination par limit/offset (200 enregistrements par défaut, 10 000 maximum).
Exemple 1 — interroger le catalogue
curl "https://data.valdourcelle.example/api/1/catalogue?theme=economie"Chargement…Exemple 2 — lire les enregistrements d'un jeu
curl "https://data.valdourcelle.example/api/1/jeux/donnees-essentielles-commande-publique/donnees?limit=2"Chargement…Exemple 3 — catalogue DCAT pour le moissonnage
curl "https://data.valdourcelle.example/api/1/dcat"Chargement…Moissonnage par les plateformes nationales et régionales
Le point d'accès DCAT permet le référencement automatique du catalogue :
- data.gouv.fr — moissonnage DCAT du portail ; chaque jeu y apparaît avec un lien vers la fiche d'origine, sans duplication de fichiers ;
- plateforme régionale de la donnée — les couches géographiques conformes aux géo-standards régionaux (dont la couche sites économiques) sont validées par l'organisme référent puis synchronisées ; les métadonnées géographiques sont exposées en ISO 19139 ;
- la collectivité reste productrice et propriétaire des données ; le moissonnage n'emporte aucun transfert de droits.