API e desvolopaires
Aqueste demonstraire es un sit estatic: lo catalòg, cada taula e las metadonadas son publicadas en fichièrs, als formats de CKAN e DCAT-AP. Pas de clau, CORS dobèrt.
Darrièr aquel sit, lo catalòg vira sul servici CKAN de la PoC (CKAN 2.11) : las meteissas donadas son servidas per l'API Action estandard de CKAN, amb recèrca, filtres e SQL sus las taulas; los clients CKAN existents e lo segador de data.gouv.fr foncionan sens cambiament.
Lo catalòg
Totes los jòcs: títol, descripcion, tèmas, formats, servici
curl '/data/search.json'
Productors (format CKAN organization_list)
Tematicas (format CKAN group_list)
Las metadonadas d'un jòc (format CKAN package_show): Licèus d'Occitània annada escolara 2025-2026
Rapòrt de governança: frescor, esquemas, licéncias e donadas personalas per jòc, per servici e per organizacion
Las taulas
Cada taula es un fichièr JSON (format DataStore de CKAN: colomnas puèi linhas), un CSV e, amb de geometrias, un GeoJSON. Exemple: Licèus d'Occitània annada escolara 2025-2026
La taula entièra en JSON
curl '/data/tables/7c36da85-6882-4144-be56-3b1200d256f4.json'
La taula entièra en CSV
Una taula amb de geometrias en GeoJSON: Licèus d'Occitània annada escolara 2025-2026
DCAT-AP
Tot lo catalòg en DCAT-AP 3 (ckanext-dcat), amb los URI europèus de frequéncia e de licéncia e las categorias de donadas de nauta valor. Cada ficha dona tanben son pròpri enregistrament DCAT.
Catalogue (RDF/XML)
Catalogue (JSON-LD)
Jòcs pròpris de la Region, dels sòcis e de lors partenaris (RDF/XML): lo flux que data.gouv.fr vendriá
Un flux unic pels uèit portals, inclusits los partenaris, sens las còpias de jòcs nacionals, que demòran publicadas per lor productor d'origina.
Los fichièrs estatics e l'API CKAN
Cada fichièr d'aqueste demonstrator correspond a una crida sul servici CKAN del PoC, qu'accepta tanben filtres, paginacion e SQL.
| Fichièr d'aqueste demonstraire | CKAN | Apèl al servici CKAN del 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> |
Lectura sens clau e sens limita de còta. L'escritura (publicacion, actualizacion) passa per un jeton d'API CKAN per productor.