Questa sezione è rivolta ai cittadini, alle imprese ed alle pubbliche amministrazioni interessate ad utilizzare i metadati del catalogo nazionale utilizzando le API.
Le API
Il portale supporta un sottoinsieme della le API di CKAN che possono essere utilizzate attraverso richieste che forniscono i risultati formattati in JSON.
Alcune delle API di CKAN disponibili sono le seguenti:
Metodo package_list / package_show
Questo metodo permette l'interrogazione dell'indice di tutti i record, tramite la chiamata https://www.dati.gov.it/api/3/action/package_list
per poi fare interrogazioni puntuali ai singoli record con la chiamata https://www.dati.gov.it/api/3/action/package_show?id={id-dataset}.
Per esempio, dalla lista dei dataset per accedere ai metadati del singolo dataset ,può essere utilizzata la chiamata: https://www.dati.gov.it/api/3/action/package_show?id=qualita-dei-corsi-di-studio
Passando, questa volta il parametro id (che si ottiene dal file JSON di risposta alla chiamata package_list) attraverso la quale è possibile acquisire i metadati del singolo dataset.
Metodo current_package_list_with_resources
Un altro metodo disponibile è la chiamata current_package_list_with_resources, che restituisce un array di oggetti di tipo dataset con tutti i campi disponibili.
La chiamata richiede un argomento limit (obbligatorio) ed - opzionalmente - un campo offset (di default = 0).
Per esempio, https://www.dati.gov.it/api/3/action/current_package_list_with_resources?limit=10
oppure https://www.dati.gov.it/api/3/action/current_package_list_with_resources?limit=10&offset=50
Attenzione: per questioni di performance si suggerisce di effettuare chiamate di massimo 100 record per volta (limit=100).
Informazioni dei cataloghi
La chiamata https://www.dati.gov.it/api/3/action/organization_list consente di ottenere la lista dei cataloghi esposti mentre l’interrogazione puntuale del catalogo è possibile con https://www.dati.gov.it/api/3/action/organization_show?id={id-catalogo}
Per esempio, dalla lista dei cataloghi, per accedere alle informazioni del singolo catalogo, può essere utilizzata la chiamata https://www.dati.gov.it/api/3/action/organization_show?id=catalogo-federato-salento-jonico
Lista amministrazioni
La chiamata https://www.dati.gov.it/api/3/action/package_search?facet.field=["holder_name"]&facet.limit=-1 consente di ottenere la lista delle amministrazioni con il rispettivo conteggio dei dataset.
Altri metodi e parametri
Per maggiori informazioni sull’utilizzo delle API di CKAN per la consultazione del catalogo fai riferimento alla documentazione di CKAN.