API-Versionen
Die API wird als einzelner GraphQL-Endpunkt unter
https://data.bafu.admin.ch/api angeboten. Es gibt weder ein Versionssegment
in der URL noch einen Versions-Header; alle Clients verwenden das aktuelle
Schema. Wesentliche Änderungen am Schema und an den Daten sind im nachstehenden
Versionsverlauf festgehalten. Die Versionen folgen der Semantischen
Versionierung (Major.Minor.Patch): Die Major-Nummer erhöht sich bei
einer nicht abwärtskompatiblen Änderung, die Minor-Nummer bei einer neuen
abwärtskompatiblen Funktion und die Patch-Nummer bei einer
abwärtskompatiblen Korrektur. Die Version hält die Weiterentwicklung des
Schemas fest und wird nicht von den Clients ausgewählt.
Versionsverlauf
Legende: Major eine nicht abwärtskompatible Änderung, die Anpassungen bei Clients erfordern kann. Minor eine neue, abwärtskompatible Funktion. Patch eine abwärtskompatible Korrektur.
| Version | Veröffentlichung | Änderung | Beschreibung |
|---|---|---|---|
1.2.0 | November 2026 | Minor | Neuer Datensatz Ökoinventardatenbank BAFU:20XY (economy_consumption.lca): die Wirkungsfaktoren der Ökoinventardatenbank des BAFU, je Version. Die Lieferungen eines Datensatzes werden nacheinander in der Reihenfolge ihres Eingangs verarbeitet. Eine ältere Lieferung überschreibt keine neuere mehr. |
1.1.0 | 2026-09-15 | Minor | Spaltenbeschreibungen auf Deutsch und Englisch. Die Filter des Generischen Downloads bieten Auswahllisten mit den vorhandenen Werten an. Korrekturen: Die Zeitstempel nawa_sampling_start_ts und nawa_sampling_end_ts von water.nawa_trend sind in UTC angegeben; bisher enthielten sie die Schweizer Ortszeit und lagen im Winter eine Stunde, im Sommer zwei Stunden zu spät. 343 457 doppelte Zeilen sind entfernt. Die Tages-, Monats- und Jahreswerte von water.observations werden für den richtigen Zeitraum geladen; ihr Zeitstempel bezeichnet den Beginn des Zeitraums in fester mitteleuropäischer Zeit (UTC+1), in UTC angegeben. |
1.0.0 | 2026-07-03 | Major | Erste öffentliche Version mit den Datensätzen water.observations und water.nawa_trend. |
Schema-Weiterentwicklung
Das Schema wird im Laufe der Zeit erweitert, sobald neue Datensätze veröffentlicht werden. Diese Änderungen sind additiv und abwärtskompatibel:
- neue Namensräume, Typen und Felder,
- neue Filterfelder auf bestehenden Typen.
Additive Änderungen wirken sich nicht auf bestehende Abfragen aus. Eine Abfrage, die eine explizite Menge von Feldern auswählt, gibt diese Felder weiterhin zurück, auch wenn an anderer Stelle im Schema neue Felder hinzukommen.
Das aktuelle Schema lässt sich jederzeit über die GraphQL-Introspektion einsehen — etwa über den GraphiQL Explorer.
Breaking Changes
Nicht abwärtskompatible Änderungen — etwa das Umbenennen oder Entfernen eines Felds oder das Ändern eines Feldtyps — werden nach Möglichkeit vermieden. Sollte eine solche Änderung unumgänglich sein, wird sie auf dieser Seite vorab angekündigt, damit betroffene Clients sich anpassen können.