Accesso ai dati · stato reale

Come si leggono i nostri dati.

Oggi Trasparenza.ai non espone una API REST propria con contratto pubblico. I dati sono leggibili tramite PostgREST di Supabase con la chiave anon pubblica, senza garanzia di stabilita degli endpoint. Il contratto programmatico stabile sara il server MCP.

Fino al 2 settembre 2026 questa pagina elencava otto endpoint sotto /api/ e due limiti di frequenza. Nessuno di quegli indirizzi ha mai restituito dati e nessun limite era applicato. Li abbiamo tolti invece di lasciarli in attesa di diventare veri.

Quello che segue funziona davvero, e si puo provare adesso incollando i comandi in un terminale.

Tabelle leggibili

Sola lettura, senza registrazione. I nomi delle tabelle e delle colonne possono cambiare senza preavviso: e la ragione per cui questa non e una API con contratto.

Tre esempi che funzionano

La chiave qui sotto e la chiave anon pubblica del progetto: e la stessa che il tuo browser riceve visitando il sito, da sola non permette nessuna scrittura ed e limitata dalle regole RLS del database.

1. La scheda di un Comune

curl -s "https://diaokmfkvomjghamdpze.supabase.co/rest/v1/comuni?slug=eq.narni&select=nome,regione,popolazione,punteggio_trasparenza,num_contratti" \
  -H "apikey: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImRpYW9rbWZrdm9tamdoYW1kcHplIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzI2ODMxMDksImV4cCI6MjA4ODI1OTEwOX0.XWaHZPrdxDEce8jn-Av7uUYKrePRhubGydiBf0QBMa4"

2. I progetti PNRR di un Comune, vista soggetto attuatore

curl -s "https://diaokmfkvomjghamdpze.supabase.co/rest/v1/comune_pnrr_attuatore?select=num_progetti,quota_pnrr&comune_id=eq.<uuid>" \
  -H "apikey: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImRpYW9rbWZrdm9tamdoYW1kcHplIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzI2ODMxMDksImV4cCI6MjA4ODI1OTEwOX0.XWaHZPrdxDEce8jn-Av7uUYKrePRhubGydiBf0QBMa4"

Esiste anche comune_pnrr_territorio. Le due viste rispondono a domande diverse, progetti gestiti dal Comune come soggetto attuatore contro progetti di qualsiasi ente localizzati sul territorio, e non vanno mai sommate: sommarle conta due volte le stesse opere.

3. I primi contratti di un Comune, dal piu recente

curl -s "https://diaokmfkvomjghamdpze.supabase.co/rest/v1/contratti?select=oggetto,importo,data_contratto&limit=20&order=data_contratto.desc" \
  -H "apikey: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImRpYW9rbWZrdm9tamdoYW1kcHplIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzI2ODMxMDksImV4cCI6MjA4ODI1OTEwOX0.XWaHZPrdxDEce8jn-Av7uUYKrePRhubGydiBf0QBMa4" \
  -H "Range: 0-19"

Da sapere prima di sommare qualcosa. Il 13,7% dei contratti non e attribuito ad alcun Comune e il 53,5% non ha un fornitore collegato: la somma delle schede comunali non coincide con il totale nazionale, e ogni vista su chi incassa copre meno della meta dei contratti. Inoltre 516 contratti hanno alla fonte un importo fuori da ogni scala plausibile, quasi sempre errori di digitazione nel dato ANAC, e vanno esclusi dai totali.

Licenza e uso