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 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.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.