Versioni dell'API
L'API è offerta come singolo endpoint GraphQL all'indirizzo
https://data.bafu.admin.ch/api. Non vi è né un segmento di versione
nell'URL né un header di versione; tutti i client utilizzano lo schema
attuale. Le modifiche rilevanti allo schema e ai dati sono registrate nella
cronologia delle versioni riportata di seguito. Le versioni seguono il
versionamento semantico (Major.Minor.Patch): il numero major aumenta in
caso di modifica non retrocompatibile, il numero minor in caso di nuova
funzionalità retrocompatibile e il numero patch in caso di correzione
retrocompatibile. La versione documenta l'evoluzione dello schema e non
viene selezionata dai client.
Cronologia delle versioni
Legenda: Major una modifica non retrocompatibile che può richiedere aggiornamenti dei client. Minor una nuova funzionalità retrocompatibile. Patch una correzione retrocompatibile.
| Versione | Data di pubblicazione | Modifica | Descrizione |
|---|---|---|---|
1.2.0 | Novembre 2026 | Minor | Nuovo set di dati Banca dati di ecoinventari BAFU:20XY (economy_consumption.lca): i fattori d'impatto della banca dati di ecoinventari dell'UFAM, per versione. Le forniture di un set di dati sono elaborate una dopo l'altra, nell'ordine in cui arrivano. Una fornitura più vecchia non sovrascrive più una più recente. |
1.1.0 | 2026-09-15 | Minor | Descrizioni delle colonne in tedesco e in inglese. I filtri del download generico offrono elenchi di selezione con i valori presenti. Correzioni: le marche temporali nawa_sampling_start_ts e nawa_sampling_end_ts di water.nawa_trend sono indicate in UTC; in precedenza contenevano l'ora locale svizzera ed erano in ritardo di un'ora in inverno e di due ore in estate. Sono state rimosse 343 457 righe duplicate. I valori giornalieri, mensili e annuali di water.observations sono caricati per il periodo corretto; la loro marca temporale indica l'inizio del periodo nell'ora dell'Europa centrale fissa (UTC+1), indicata in UTC. |
1.0.0 | 2026-07-03 | Major | Versione iniziale con i set di dati water.observations e water.nawa_trend. |
Evoluzione dello schema
Lo schema viene ampliato nel tempo, man mano che vengono pubblicati nuovi set di dati. Queste modifiche sono additive e retrocompatibili:
- nuovi spazi dei nomi, tipi e campi,
- nuovi campi di filtro sui tipi esistenti.
Le modifiche additive non influiscono sulle query esistenti. Una query che seleziona un insieme esplicito di campi continua a restituire tali campi anche quando altrove nello schema vengono aggiunti nuovi campi.
Lo schema attuale può essere ispezionato in qualsiasi momento tramite l'introspezione GraphQL — ad esempio tramite l'Explorer GraphiQL.
Modifiche non retrocompatibili
Le modifiche non retrocompatibili — come la ridenominazione o la rimozione di un campo o la modifica del tipo di un campo — vengono evitate ove possibile. Qualora una tale modifica risultasse inevitabile, viene annunciata in anticipo su questa pagina, affinché i client interessati possano adeguarsi.