Kompatible Evolution, explizite Migrationen.
Die Hauptversion befindet sich in der URL. Additive Änderungen werden in Version 1 übernommen, ohne dass Clients beschädigt werden. Inkompatible Änderungen erfordern eine neue Version und ein neues Migrationsfenster.
Was könnte sich in v1 ändern?
Zusätzliche Vorgänge und Funktionen können veröffentlicht werden.
Clients sollten unbekannte Eigenschaften in Antworten ignorieren.
Bei Abonnements mit * können Typen zum Katalog hinzugefügt werden.
Offene Aufzählungen können dokumentierte Zustände oder Anbieter erhalten.
Was erfordert eine neue Version?
Vorhandene Endpunkte, Felder oder Werte verschwinden nicht automatisch.
Inkompatible Semantik, Einheit oder Format erfordern einen neuen Vertrag.
Ein optionales Feld wird innerhalb derselben Version nicht zu einem Pflichtfeld.
Inkompatible Berechtigungsänderungen erhalten eine eigene Migration.
Abschreibungszyklus
Mit Ersatz und Wirkung geht der Wandel in die Geschichte ein.
Die beiden Formen existieren während des Informationsfensters nebeneinander.
Dokumentation und Antworten identifizieren den gekündigten Vertrag.
Der Abtransport erfolgt nur zum angekündigten Termin.