API en ontwikkelaars
Deze demo is een statische site: de catalogus, elke tabel en de metadata worden als bestanden gepubliceerd, in CKAN- en DCAT-AP-formaat. Zonder sleutel, open CORS.
In productie draait de catalogus op CKAN: dezelfde gegevens worden aangeboden via de standaard Action API van CKAN, met zoeken, filters en SQL op de tabellen; bestaande CKAN-clients en de harvester van data.gouv.fr werken ongewijzigd.
De catalogus
Alle datasets: titel, beschrijving, thema’s, formaten, dienst
curl '/data/search.json'
Uitgevers (CKAN-formaat organization_list)
Thema’s (CKAN-formaat group_list)
De metadata van een dataset (CKAN-formaat package_show): guichets distribution sacs
Governancerapport: actualiteit, schema’s, licenties en persoonsgegevens per dataset, per dienst en per organisatie
De tabellen
Elke tabel is een JSON-bestand (DataStore-formaat van CKAN: kolommen en dan rijen), een CSV en, met geometrieën, een GeoJSON. Voorbeeld: guichets distribution sacs
De volledige tabel in JSON
curl '/data/tables/0256ac56-7995-4bea-bf40-0a7308514f84.json'
De volledige tabel in CSV
Een tabel met geometrieën in GeoJSON: guichets distribution sacs
DCAT-AP
De datasets van deze demo in DCAT-AP 3 (ckanext-dcat), met de Europese URI’s voor frequentie en licentie en de categorieën van hoogwaardige datasets. Elke datasetpagina geeft ook haar eigen DCAT-record.
Catalogus (RDF/XML)
Catalogus (JSON-LD)
Datasets van de Communauté urbaine en de Ville de Dunkerque (RDF/XML): wat data.gouv.fr zou oogsten
Het oude adres van de DCAT-export van data.dunkerque-agglo.fr verwijst hiernaar door.
/api/explore/v2.1/catalog/exports/dcat
Oude exportadressen
Géo2France oogst elke dag de 174 datasets via de exportadressen van de Explore-API. Voor de 71 datasets in deze demo verwijzen ze door naar de kopieën ervan (CSV en GeoJSON met dezelfde inhoud; de JSON is in het DataStore-formaat van CKAN); voor de andere naar het huidige portaal:
/api/explore/v2.1/catalog/datasets/guichets-distribution-sacs/exports/csv /api/explore/v2.1/catalog/datasets/guichets-distribution-sacs/exports/json /api/explore/v2.1/catalog/datasets/guichets-distribution-sacs/exports/geojson
De statische bestanden en de CKAN-API
Elk bestand van deze demo komt overeen met een CKAN-oproep; op de CKAN-dienst accepteren de oproepen ook filters, paginering en SQL.
| Bestand in deze demo | CKAN | Oproep op de CKAN-dienst |
|---|---|---|
| /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?fq=organization:communaute-urbaine-de-dunkerque |
Lezen zonder sleutel en zonder quotum. In productie gebeurt schrijven (publiceren, bijwerken) met één CKAN-API-token per dienst.