La piattaforma ComunWeb espone automaticamente i propri contenuti pubblici utilizzando il paradigma Linked Open Data.
Linked Open Data
Licenza per i contenuti
I contenuti di questo sito sono rilasciati sotto licenza Creative Commons (CCBY) , salvo dove è diversamente specificato.
Questo significa che, ove non diversamente specificato, i contenuti di questo sito sono liberamente distribuibili e riutilizzabili, a patto che sia sempre citata la fonte e riportato l'indirizzo web della pagina originale.
OpenData
Tutti i contenuti del sito possono essere liberamente estratti in formato strutturato, attraverso due diversi criteri:
- link diretti a file in formato CSV (compatibile con i software per i fogli di calcolo come Microsoft Excel e OpenOffice Calc), per i cittadini senza particolari competenze informatiche
- API RESTful in formato JSON, per programmatori
Formato CSV
Nel rispetto della licenza sopra citata (CCBY), chiunque può scaricare i contenuti strutturati presenti nel sito, utilizzando un link nella forma /exportas/csv/<tipologia_di_contenuto>, ad esempio:
- per scaricare la lista degli eventi: /exportas/csv/event
- per scaricare la lista delle determinazioni: /exportas/csv/determinazione
- per scaricare la lista delle deliberazioni: /exportas/csv/deliberazione
Qualora l'accesso non risultasse possibile, si prega di contattare il Consorzio dei Comuni Trentini <innovazione@consorziocomuni.it>.
API RESTful
Nel rispetto della licenza sopra citata (CCBY), chiunque può accedere al seguente link:
che espone:
- la lista di tutti i dataset pubblicati sul sito, completi di relativi metadati
- la lista di tutti i dataset contenenti informazioni strutturate gestite da ComunWeb, in formato JSON: /api/opendata/v1/content/classList
Alcuni esempi pratici:
- elenco navigabile delle determinazioni: /api/opendata/v1/content/class/determinazione
- elenco navigabile degli eventi: /api/opendata/v1/content/class/event
- elenco degli ultimi 100 eventi: /api/opendata/v1/content/class/event/offset/0/limit/100
Seguendo i singoli link, si raggiunge il singolo documento con i relativi metadati.
Riferimenti normativi
- Legge Provinciale n° 16/2012: Disposizioni per la promozione della società dell'informazione e dell'amministrazione digitale e per la diffusione del software libero e dei formati di dati aperti
- Agenda per l'Italia Digitale: Linee guida per l'interoperabilità semantica attraverso i Linked Open Data
- Codice dell'Amministrazione Digitale , articolo 52, comma 6 e 7
- Agenda per l'Italia Digitale: Linee guida nazionali per la valorizzazione del patrimonio informativo pubblico , che hanno valenza per il secondo semestre del 2013