Versionierung & Abkündigung
Die Pfad-Version /api/v1 ist der Vertrag.
Pfad-Version
Abwärtskompatible Erweiterungen (neue Felder, neue Endpunkte) erscheinen innerhalb von v1. Breaking Changes kommen nur als v2.
Abkündigung
Abgekündigte Endpunkte tragen die Header Deprecation, Sunset und Link zur Migration — mindestens zwölf Monate vor dem Abschalten.
http
Deprecation: @1788480000
Sunset: Sat, 06 Sep 2027 00:00:00 GMT
Link: <https://www.claritos.io/developers/changelog>; rel="deprecation"Changelog
Jede Änderung steht im Changelog mit Version und Datum. Die OpenAPI-Datei trägt dieselbe Version.