Versionierung
Stabile Hauptversionen und angekündigte Ablösung.
Der Pfad /v1 bezeichnet die Hauptversion. Neue optionale Felder, zusätzliche Endpunkte und neue Antwortwerte können innerhalb von v1 erscheinen. Clients sollten unbekannte Antwortfelder tolerieren.
Entfernte Felder, neue Pflichtparameter und andere inkompatible Änderungen erfordern eine neue Hauptversion. v1 bleibt mindestens zwölf Monate parallel verfügbar.
Eine abgekündigte Route sendet Deprecation, Sunset und einen Link zur Nachfolgeversion. Zwischen Ankündigung und Sunset liegen mindestens sechs Monate. Nach dem Sunset liefert die Route 410 Gone.
OpenAPI-Änderungen werden in CI auf inkompatible Änderungen geprüft. Das Changelog beschreibt die veröffentlichten Änderungen.