Sviluppatori

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