Salta il menu di navigazione del canale

API INPS

Le specifiche Application Programming Interface (API) dell’INPS descrivono un set di funzioni che consentono agli utenti di interagire con il DataCatalog Opendata. Insieme al portale Opendata, dove è possibile recuperare le risorse open distribuite come files di download (xls,csv,xml), le API permettono un accesso veloce alla lista completa dei dataset e dei relativi metadati. Gli sviluppatori web possono utilizzare le richieste di accesso per avere le informazioni aggiornate giornalmente a supporto dei propri applicativi. Le condizioni di accesso alle risorse dati sono definite della licenza IODL2.0 associata a ciascun dataset con la cui applicazione si incoraggia il riuso, la distribuzione, e la creazione di lavori derivati dall’utilizzo dei dati pubblicati.

Richieste base

Per accedere alle funzionalità REST-based è necessario comporre una chiamata HTTP GET costruendo la URL. Le chiamate API supportano i seguenti parametri:

Formato di Risposta

Tutte le request restituiscono output in formato JSON. Per visualizzare in modo più chiaro l’output, è possibile incollare la risposta all’interno del JSON LINT validator. Le chiavi del JSON sono in linea con la v.2 delle API CKAN.
Le due request di bulk sfruttano il JSON-LD (JSON for Linked Data) per definire i vocabolari semantici utilizzati nel modello metadati degli Opendata INPS. Il vocabolario DCATFOAF descrivono la struttura del datacatalog e le informazioni di provenance per la trasparenza dell’ente e dei responsabile del datastore INPS. Il vocabolario DC definisce i metadati descrittivi associati ai dataset e ai formati di distribuzione.
Le chiamata di status, sempre in JSON, restituisce informazioni sulla versione API attualmente attiva, il count dei bulk download e relativa dimensione. Sono anche definite le informazioni sulla frequenza di aggiornamento del datacatalog sia in versione human-readable, sia in versione cron per una più comoda pianificazione periodica dei comandi in ambiente Unix. 


Leggi questo articolo in formato PDFTorna su all'inizio del contenuto.

Contenuti correlati

Ultimi Opendata pubblicati

Conto Economico
Bilancio preventivo 2016. Conto economico
Conto Economico GIAS (Gestione Interventi Assisten...
Bilancio preventivo 2016. Conto economico GIAS (Gestione degli in...
Decisionale Entrate
Bilancio preventivo 2016. Decisionale entrate
Decisionale Uscite
Bilancio preventivo 2016. Decisionale uscite
Gestionale Entrate
Bilancio preventivo 2016. Gestionale entrate