Demonstratie van Datopian, geen officiële website van de Communauté urbaine de Dunkerque

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.

docs.ckan.org/en/2.11/api

De catalogus

Alle datasets: titel, beschrijving, thema’s, formaten, dienst

/data/search.json
curl
curl '/data/search.json'

Uitgevers (CKAN-formaat organization_list)

/data/organizations.json

Thema’s (CKAN-formaat group_list)

/data/groups.json

De metadata van een dataset (CKAN-formaat package_show): guichets distribution sacs

/data/datasets/guichets-distribution-sacs.json

Governancerapport: actualiteit, schema’s, licenties en persoonsgegevens per dataset, per dienst en per organisatie

/data/quality.json

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

/data/tables/0256ac56-7995-4bea-bf40-0a7308514f84.json
curl
curl '/data/tables/0256ac56-7995-4bea-bf40-0a7308514f84.json'

Een tabel met geometrieën in GeoJSON: guichets distribution sacs

/data/tables/0256ac56-7995-4bea-bf40-0a7308514f84.geojson

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 (Turtle)

/catalog.ttl
curl
curl '/catalog.ttl'

Catalogus (RDF/XML)

/catalog.xml

Catalogus (JSON-LD)

/catalog.jsonld

Datasets van de Communauté urbaine en de Ville de Dunkerque (RDF/XML): wat data.gouv.fr zou oogsten

/catalog-cud-ville.xml

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.

De statische bestanden en de CKAN-API
Bestand in deze demoCKANOproep op de CKAN-dienst
/data/search.jsonpackage_search/api/3/action/package_search?q=…&fq=groups:finances
/data/datasets/<name>.jsonpackage_show/api/3/action/package_show?id=<name>
/data/organizations.jsonorganization_list/api/3/action/organization_list?all_fields=true
/data/groups.jsongroup_list/api/3/action/group_list?all_fields=true
/data/tables/<id>.jsondatastore_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, .jsonldckanext-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.