-
Area istituzionale
In quest'area sono presenti le voci di menu che ti consentono di accedere alle sezioni che compongono il portale dell'Istituto.
-
Seleziona lingua
Selezionando questo pulsante si aprirà un menu a tendina che ti permetterà di selezionare la lingua che preferisci tra quelle disponibili.
-
Accedere ai servizi
Nella sezione "Accedere ai servizi" potrai trovare tutte le informazioni sulle credenziali di autenticazione necessarie per l’accesso ai servizi online.
-
I contatti dell'INPS
Accedendo a questa sezione puoi avere informazioni sui canali utilizzati da INPS per essere in contatto con la propria utenza. Inoltre, trovi le FAQ sull'utilizzo del portale e indicazioni su come ottenere e gestire il PIN.
-
Entra in MyINPS
Selezionando il pulsante puoi effettuare l'autenticazione per accedere alla tua area riservata. Se non sei già in possesso delle credenziali, puoi utilizzare il link dedicato per scoprire come ottenerle.
-
Cerca nel portale
Attraverso questo strumento puoi indicare delle parole chiave per trovare i contenuti di tuo interesse all'interno del portale.
-
Contenuti in evidenza
In quest'area sono presenti i contenuti posti in primo piano dall'Istituto.
-
Navigazione per utenti e temi
In quest'area puoi accedere ai contenuti collegati alle singole categorie di utenza o ai singoli temi di tuo interesse.
-
Ti potrebbero interessare
In quest'area puoi consultare i contenuti correlati ai tuoi interessi.
-
Servizi più utilizzati
Qui puoi trovare i servizi più utilizzati dagli altri utenti.
-
Accesso rapido
In quest'area sono raccolti i contenuti del portale più condivisi sui social media, i più visti e quelli maggiormente cercati dagli utenti. Il numero dei contenuti visualizzati può essere esteso utilizzando le voci dedicate.
-
Social stream
In quest'area sono raccolti, in ordine cronologico, i post Facebook e i tweet pubblicati da INPS.
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, json, owl), le API permettono un accesso veloce alla lista completa dei dataset, dei relativi metadati e dei dati. 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:
- Package_list - La chiamata restituisce l'indice di tutti i dataset del catalogo, ovvero l'elenco dei rispettivi ID.
https://serviziweb2.inps.it/odapi/package_list - Package_show - La chiamata restituisce l'estrazione di tutti i metadati e i formati di distribuzione riguardanti il dataset identificato da un ID numerico.
https://serviziweb2.inps.it/odapi/package_show?id={id-dataset} - Current_package_list_with_resources - La chiamata restituisce una copia dell'intero datacatalog INPS, ovvero tutti i metadati relativi ai dateset INPS. Supporta parametri limit ed offset per paginare.
https://serviziweb2.inps.it/odapi/current_package_list_with_resources?limit=50 - Bulk - La chiamata restituisce una copia di tutto il datastore INPS comprensivo sia dei dati che dei metadati relativi a ciascun dataset.
https://serviziweb2.inps.it/odapi/bulk?limit=50 - Bulk download - La chiamata restituisce una copia di tutto il datastore INPS comprensivo sia dei dati che dei metadati relativi a ciascun dataset, come file di download. Supporta parametri limit ed offset per paginare.
https://serviziweb2.inps.it/odapi/bulk_download?limit=50 - Status - La chiamata restituisce le informazioni sullo stato della piattaforma API e dei servizi erogati.
https://serviziweb2.inps.it/odapi/status
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.3 delle API CKAN.
Le due request di bulk sfruttano il JSON-LD (JSON for Linked Data) per esprimere i vocabolari semantici utilizzati nel modello metadati degli Opendata INPS. Il vocabolario DCAT e FOAF e Dublin Core descrivono la struttura del datacatalog, i metadati e le informazioni di provenance per garantire la trasparenza dell'Istituto.
La 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 in versione cron per una più comoda pianificazione periodica dei comandi in ambiente Unix.
Per avere indicazioni tecniche su come utilizzare le API si può consultare la pagina: https://www.dati.gov.it/content/sviluppatori