Tutto quello che VOCE mostra in pagina si può anche scaricare. Senza registrarsi, senza chiedere una chiave, senza dire chi sei. Sono quattro raccolte in formato JSON e CSV, pensate per chi fa ricerca e per chi fa giornalismo.
Licenza
I dati sono rilasciati con licenza Creative Commons Attribuzione 4.0. Puoi usarli, anche a scopo commerciale. Devi solo citare VOCE come fonte. Il codice della piattaforma è invece rilasciato con licenza AGPL 3.0.
Ogni indirizzo risponde a una richiesta di lettura. Aggiungi ?formato=csv per scaricare un file al posto della risposta in JSON.
/api/public/gruppi
Un gruppo per riga: di cosa parla, dove, quante persone lo hanno segnalato.
id · titolo · riassunto · categoria · comune · quartiere · segnalazioni · cittadini · stato · latitudine · longitudine · raggio_metri · soglia_raggiunta_il · creato_il · aggiornato_il
formato · citta · categoria · dal · al · limite · offset
/api/public/atti
Gli atti civici nati dai gruppi: tipo, destinatario, firme, termine di legge.
id · gruppo_id · tipo · stato · titolo · destinatario · revisionato · revisionato_da · firme · firme_obiettivo · inviato_il · risposta_ricevuta_il · termine_il · termine_giorni · termine_base · seguito_di · creato_il · pdf_url · docx_url · testo_markdown · testo_risposta
formato · citta · tipo · stato · dal · al · limite · offset
/api/public/risposte
Cosa hanno risposto le amministrazioni, con l’esito e il motivo del rifiuto.
id · atto_id · esito · motivo · cita_art_5bis · rimedio_proposto · ricevuta_il · confermata_il
formato · citta · esito · dal · al · limite · offset
/api/public/comuni
Una riga per comune: quanto è stato segnalato, quanto è stato risposto e in quanti giorni.
comune · gruppi · segnalazioni · cittadini · atti_inviati · risposte_ricevute · risposte_confermate · giorni_medi_di_risposta · accolte · respinte · interlocutorie · irricevibili
formato · citta · limite · offset
| Parametro | Valori | Da sapere |
|---|---|---|
| formato | json · csv | Se non lo indichi ricevi JSON. |
| citta | nome del comune | Deve corrispondere esatto, comprese le maiuscole. |
| categoria | sanita · mobilita · ambiente · … | Solo sui gruppi. |
| tipo · stato · esito | valori elencati sopra | Un valore sbagliato ti dice quali sono ammessi. |
| dal · al | AAAA-MM-GG | Estremi inclusi. Le date si intendono in UTC. |
| limite | da 1 a 1000 | Se non lo indichi ricevi 100 righe. |
| offset | da 0 in su | Serve a scaricare la pagina successiva. |
Se sbagli un parametro ricevi il codice 400 e una spiegazione in italiano. Dice quale parametro correggere e quali valori accetta.
Queste raccolte leggono le stesse viste che alimentano le pagine pubbliche. Non c’è una via privilegiata: quello che non si vede in pagina non si scarica nemmeno da qui.
Un dato mancante non è una dimenticanza. Ogni esclusione protegge una persona che ha raccontato un problema fidandosi di noi.
Prima riga con i nomi delle colonne, virgola come separatore. Il file inizia con il segno UTF-8, così gli accenti si leggono anche in Excel. Se le colonne restano attaccate, apri il file da Dati, Da testo/CSV e scegli la virgola.
Non è un elenco nudo ma un oggetto. Le righe stanno in dati; accanto trovi totale, generato_il, licenza e una nota. Così possiamo aggiungere un campo senza rompere il tuo programma.
Le risposte restano in memoria cinque minuti. Per un lavoro ripetuto va benissimo interrogarle una volta al giorno.
La lettura è consentita da qualunque origine. Puoi usare questi indirizzi da una pagina tua o da un quaderno di calcolo, senza passaggi intermedi.
Il quadro pubblico mostra gli stessi numeri già letti e commentati. Manca un dato che ti servirebbe? Dillo: se si può pubblicare senza esporre nessuno, lo pubblichiamo.
Vai al quadro pubblico