Descrizione breve
CKAN è un software open source per cataloghi dati (sito web del progetto: https://ckan.org/ ). Utilizziamo CKAN per la nostra raccolta di dati https://data.opentransportdata.swiss/.
L’API CKAN consente di accedere ai metadati relativi ai nostri set di dati e alle API (ad es. link per il download, data di aggiornamento, ecc.) e di utilizzarli secondo necessità.
Accesso all’API:
- https://api.opentransportdata.swiss/ckan-api/package_list
- https://api.opentransportdata.swiss/ckan-api/package_show?id=dataset_name
Per l’accesso è necessaria una chiave API: Howto: Accesso alle nostre API con API Keys.
Descrizione del funzionamento
Gestiamo tutti i nostri circa 90 record di dati (1000+ risorse/file) e le nostre API in CKAN. CKAN memorizza una serie di metadati relativi ai record e alle risorse, tra cui:
- Nomi (titoli) e descrizioni brevi dei record di dati e delle risorse
- Data e ora di creazione e aggiornamento
- Tipi di supporti (mime types)
- Permalink, link per il download e link alla documentazione (cookbook)
Questi metadati vengono visualizzati sulle pagine web, ma possono anche essere richiamati tramite l’API CKAN e utilizzati in un’applicazione.
Descrizione tecnica
Per accedere all’API è necessaria una chiave API. Per le istruzioni vedere qui:
https://opentransportdata.swiss/de/cookbook/development-miscellaneous-cookbook/howto-access-apis/
L’API è una semplice API REST. Sostanzialmente è possibile utilizzare questi due endpoint:
- https://api.opentransportdata.swiss/ckan-api/package_list fornisce un elenco dei set di dati (nomi, «slugs»)
- https://api.opentransportdata.swiss/ckan-api/package_show?id=dataset_name fornisce metadati dettagliati sul dato
dataset_name. Sul camporessourcessono elencati i dati rilevanti per ogni singola risorsa.
Le risposte sono formattate in JSON. Le affermazioni e i contenuti sono ampiamente autoesplicativi.
Nota bene
- L’API CKAN deve essere utilizzata solo per interrogazioni occasionali su singoli record, non per frequenti scansioni complete e simili.
- I metadati possono essere richiamati anche tramite i file DCAT Catalog:
Ulteriori indicazioni
- http://ckan.de/das-open-data-projekt/
- http://docs.ckan.org/latest/api/
- https://en.wikipedia.org/wiki/Data_Catalog_Vocabulary
#AutoTranslate