Utilizzo dei Web Service dell’Indice delle Pubbliche Amministrazioni

Appunti di lavoro

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.

Nei primi minuti, mi sento così

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):

http --form POST https://www.indicepa.gov.it:443/public-ws/WS02_AOO.php AUTH_ID="MioCodice" COD_AMM="r_sicili"

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à

curl -X POST -F 'AUTH_ID=xxxx' -F 'COD_AMM=r_sicili' https://www.indicepa.gov.it:443/public-ws/WS02_AOO.php

Punto