Utilizzo dei Web Service dell’Indice delle Pubbliche Amministrazioni

L’Indice delle Pubbliche Amministrazioni (IPA) è l’archivio ufficiale degli Enti pubblici e dei Gestori di pubblici servizi. È realizzato e gestito dall’Agenzia per l’Italia digitale.

Almeno una volta l’anno ho la necessità di accedere via Web Service ai dati relativi, ma ogni volta non ricordo come si faccia. Allora mi rileggo la documentazione (non la capisco mai rapidamente, sono di “coccio”), mi faccio rimandare l’Authorization ID (perché non l’annoto mai) e infine — ARGH — riesco a usarla.

Questo post vale come nota personale, da rileggere quando mi servirà nuovamente.

Un solo esempio: ottenere la “Lista delle Aree Organizzative Omogenee di un Ente”. Il servizio dedicato è “WS02_AOO”, documentato qui.

I servizi web sono disponibili su INTERNET all'indirizzo del portale IPA www.indicepa.gov.it, port 443 e protocollo HTTPS.
L’URL di ogni servizio si ottiene anteponendo all’ENDPOINT il suffisso www.indicepa.gov.it/public-ws/.
Il protocollo da utilizzare per la Request è REST/POST. Ogni Request deve includere il parametro AUTH_ID il cui valore si ottiene attraverso il sito
www.indicepa.gov.it nell’area Utente Pubblico/Web Services Pubblici, previa registrazione dell’utente e di una propria casella email.

Basta quindi una chiamata come quella di sotto (è basata su httpie):

Vengono specificati:

  • il metodo per fare la richiesta con --form POST;
  • il codice di autenticazione conAUTH_ID;
  • e infine il codice della PA di cui voglio l’elenco delle Aree Organizzative Omogenee, con COD_AMM, che nel mio caso è la Sicilia (che ha codice r_sicili).

In output avrò un file JSON con l’elenco.

Con curl sarà

Punto

#data #maps #GIS #baci #condivisione. Orgoglioso di essere presidente di @ondatait

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store