Indicatori e valori
Restituisce i valori finali degli indicatori pubblicati dall'Osservatorio.
GET /api/v1/indicatorsFiltri: indicator, territory, year, sector, category, limit, offset
Open data · API
API pubblica v1
L'API espone in sola lettura dati e relazioni già pubblicati dal Centro Studi. La versione v1stabilizza i percorsi pubblici senza sostituire le pagine metodologiche e le fonti originarie.
Endpoint
Apri JSON →
Paesi dell'Atlante
Restituisce soltanto i Paesi del perimetro che dispongono di evidenze pubblicate.
GET /api/v1/atlas/countriesFiltri: —
Rotte dell'Atlante
Restituisce soltanto le rotte origine-destinazione che dispongono di evidenze pubblicate.
GET /api/v1/atlas/routesFiltri: —
Contesto di ricerca verificabile
Restituisce risultati pubblici ordinati per pertinenza con riferimenti citabili. Non genera risposte AI.
GET /api/v1/context?q=termineFiltri: q, limit
Knowledge Graph derivato
Espone nodi e relazioni ricavati dai dati pubblicati tra Paesi, indicatori, settori e rotte.
GET /api/v1/graphFiltri: —
Esempio
GET /api/v1/indicators?indicator=imprese-straniere-registrate&territory=IT-25&year=2025&limit=500&offset=0Le risposte includono versione, data di generazione, numero di record e filtri applicati quando pertinenti. Il campo quality_code conserva la qualificazione editoriale del valore. Gli endpoint di contesto e grafo espongono soltanto relazioni o risultati riconducibili a materiale pubblico.
Limiti tecnici
Gli endpoint sotto /api/ sono protetti a livello Netlify da un limite di 60 richieste per 60 secondi per combinazione IP e dominio. Le richieste oltre soglia ricevono risposta HTTP 429.
/api/v1/indicators restituisce al massimo 1.000 record per risposta; il valore predefinito è 500. Usa limit e offset per scorrere i risultati. La risposta espone anchetotal_count e pagination.has_more.
Gli endpoint pubblici impostano caching CDN dove appropriato per ridurre richieste ripetute al database. I limiti sono una protezione operativa e possono essere rivisti se il volume d'uso reale lo richiede.
Regole di utilizzo
L'API è pubblica e in sola lettura. Non garantisce che indicatori differenti siano comparabili tra loro. Definizione, unità, popolazione osservata, periodo, metodologia e condizioni di riuso della fonte primaria devono essere considerate prima di ogni elaborazione o redistribuzione.