API INAPP è l’end point, ovvero il canale ufficiale per la diffusione dei dati e dei metadati in formato machine readable, dell'Istituto per le Analisi e le Politiche Pubbliche.
API INAPP è un'innovazione tecnologica e metodologica che coinvolge l'intero processo di produzione dei dati attraverso l'industrializzazione dei processi, la validazione delle informazioni e la diffusione. Nel corso degli anni, le politiche di condivisione dei dati adottate dall'INAPP hanno facilitato le collaborazioni istituzionali, oltre ad aver dato vita al Sistema Informativo Professioni, l'unica rete di istituzioni, a livello europeo, che alimenta continuamente un prezioso sistema distribuito rivolto alla cittadinanza e ai decisori politici. Le evoluzioni tecnologiche attualmente disponibili consentono all'INAPP di compiere un ulteriore passo in avanti verso le istituzioni e più in generale verso la cittadinanza.
API INAPP è uno strumento di diffusione dei dati basato sull'architettura REST (Representational State Transfer) e su ampi set tematici di API (Application Programming Interface). L'INAPP, in un'ottica orientata alla gestione e alla visualizzazione dei Big Data, adotta lo stack Elastic, che rappresenta un'interfaccia REST nativa. Per facilitare l'utilizzo delle API è stata predisposta un'adeguata documentazione descrittiva.
Tutti i dati prodotti dall’INAPP sono rilasciati sotto licenza Italian Open Data License v2.0: è possibile riprodurre, distribuire, trasmettere e adattare liberamente dati e analisi dell’INAPP, anche a scopi commerciali, a condizione che venga citata la fonte.
L’INAPP contribuisce in modo sostanziale alla produzione di dati statistici. Attualmente, attraverso API INAPP vengono rilasciati i dati e i metadati relativi all'Indagine campionaria sulle professioni, alla Classificazione delle Professioni (CP2021) e agli strumenti di diffusione e di codifica relativi al Sistema Informativo Professioni. Successivamente, verranno resi disponibili i metadati relativi alle altre attività dell'istituto. I dati e i metadati sono diffusi in formato JSON: in futuro saranno disponibili anche in altri formati (CSV, EXCEL) all'interno del corporate data warehouse INAPP.Stat.
Le API possono essere consultate attraverso quesy string, in modalità GET o POST, composte nel seguente modo:
https://api.inapp.org/area/metodo?parametri
I risultati, generalmente, sono costituiti da oggetti JSON facilmente elaborabili in qualsiasi linguaggio di programmazione.
Il Sistema Informativo Professioni è un sistema LOD che prevede una gestione distribuita dei dati.
Il fulcro su cui si basa il progetto è la "Classificazione delle Professioni (CP2021)" realizzata dall'ISTAT.
Nel passaggo da un sito all'altro, non è previsto uno scambio di dati, database o quant'altroviene scambiato soltanto il codice della professione, attraverso un link del tipo http://www.sitoente.it/index.php?id=3.2.2.1.1
Gli Enti che aderiscono al sistema debbono essere in grado di:
1) RISPONDERE ALLA CHIAMATA, rimandando ad una pagina contenente i dati della specifica unità professionale identificata dal codice della professione fornito nel link.
2) RIMANDARE AGLI ALTRI ENTI, fornendo una lista di link agli altri enti aggiornata
Questo obbligo esiste soltanto per quelle professioni per le quali si decide di fornire dati e/o informazioni. Per le professioni su cui non si dispone di infromazioni, non sono previsti link e conseguenti "obblighi" di risposta e di chiamata.