Descrizione breve
CKAN è un software open source per catalogo dati (sito web del progetto: https://ckan.org/ ). Utilizziamo CKAN per la nostra raccolta di dati https://data.opentransportdata.swiss/.
Tramite l’API CKAN, i metadati relativi ai nostri record di dati e API (ad es. link per il download, data di aggiornamento, ecc.) possono essere recuperati e utilizzati 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 set di dati (1000+ risorse o file) e le nostre API in CKAN. CKAN memorizza una serie di metadati per i set di dati e le risorse, tra cui:
- Nomi (titolo) e descrizioni brevi dei record di dati e delle risorse
- Data e ora di creazione e aggiornamento
- Tipi di media (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 è semplicemente un’API REST. In sostanza, è 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. Nel camporessourcessono elencate le informazioni rilevanti per ogni singola risorsa.
Le risposte sono formattate in JSON. Le riprese dei campi e il contenuto sono in gran parte autoesplicativi.
Nota bene
- L’API CKAN deve essere utilizzata solo per query occasionali su singoli record di dati, non per frequenti scansioni complete e simili.
- I metadati possono essere richiamati anche tramite i file di catalogo DCAT:
Ulteriori indicazioni
- http://ckan.de/das-open-data-projekt/
- https://docs.ckan.org/en/latest/api/
- https://en.wikipedia.org/wiki/Data_Catalog_Vocabulary
#AutoTranslate