API i desenvolupadors
Aquest demostrador és un lloc estàtic: el catàleg, cada taula i les metadades es publiquen en fitxers, en formats de CKAN i DCAT-AP. Sense clau, CORS obert.
Al darrere d'aquest lloc web, el catàleg gira sobre el servei CKAN de la PoC (CKAN 2.11) : les mateixes dades s'utilitzen per’API Acció estàndard de CKAN, amb cerca, filtres i SQL a les taules; els clients CKAN existents i el segador de data.gouv.fr funcionen sense canvis.
El catàleg
Tots els jocs: títol, descripció, temes, formats, servei
curl '/data/search.json'
Productors (format CKAN organization_list)
Tems (format CKAN group_list)
Les metadades d'un joc (format CKAN package_show): Lycées d'Occitània any escolar 2025-2026
Informe de governança: frescor, esquemes, llicències i dades personals per joc, servei i organització
Les taules
Cada taula és un fitxer JSON (format DataStore de CKAN: columnes després línies), un CSV i, amb geometries, un GeoJSON. Exemple: Lycées d'Occitània any escolar 2025-2026
La taula completa en JSON
curl '/data/tables/7c36da85-6882-4144-be56-3b1200d256f4.json'
La taula completa en CSV
Una taula amb geometries en GeoJSON: Lycées d'Occitània any escolar 2025-2026
DCAT-AP
Tot el catàleg en DCAT-AP 3 (ckanext-dcat), amb els URI europeus de freqüència i llicència i les categories de dades de gran valor. Cada fitxa també dóna el seu propi registre DCAT.
Catàleg (RDF/XML)
Catàleg (JSON-LD)
Jocs propis de la regió, dels membres i dels seus socis (RDF/XML): el flux que data.gouv.fr recolliria
Un flux únic per als vuit portals, inclosos els socis, sense les còpies de jocs nacionals, que romanen publicades pel seu productor d'origen.
Els fitxers estàtics i l'API CKAN
Cada fitxer d'aquest demostrador correspon a una crida al servei CKAN del PoC, que també accepta filtres, paginació i SQL.
| Arxiu d'aquest demostrador | CKAN | Apel·lació al servei 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> |
Llectura sense clau i sense límit de quota. L'escriptura (publicació, actualització) passa per un token d'API CKAN per productor.