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

ANF concessi dai comuni. Numero beneficiari per ar...
Assegni al nucleo familiare concessi dai comuni. Numero beneficia...
ANF concessi dai comuni. Numero beneficiari per cl...
Assegni al nucleo familiare concessi dai comuni. Numero beneficia...
Anf lavoratori parasubordinati. Media annua benefi...
Assegni al nucleo familiare, lavoratori parasubordinati. Importo ...
Anf lavoratori parasubordinati. Media annua benefi...
Assegni al nucleo familiare, lavoratori parasubordinati. Importo ...
Anf lavoratori parasubordinati. Numero beneficiari...
Assegni al nucleo familiare, lavoratori parasubordinati. Numero e...