Compatibele evolutie, expliciete migraties.
De hoofdversie staat in de URL. Additieve wijzigingen worden in v1 doorgevoerd zonder clients te verbreken; Incompatibele wijzigingen vereisen een nieuwe versie en een nieuw migratievenster.
Wat zou er kunnen veranderen in v1
Er kunnen aanvullende bewerkingen en functies worden gepubliceerd.
Klanten moeten onbekende eigenschappen in reacties negeren.
Aan abonnementen met * kunnen typen worden toegevoegd aan de catalogus.
Open enums kunnen gedocumenteerde statussen of providers verkrijgen.
Wat vereist een nieuwe versie
Bestaand eindpunt, veld of waarde verdwijnt niet stilletjes.
Incompatibele semantiek, eenheid of formaat vereist een nieuw contract.
Een optioneel veld wordt binnen dezelfde versie niet verplicht.
Incompatibele autorisatiewijzigingen krijgen hun eigen migratie.
Afschrijvingscyclus
Verandering gaat de geschiedenis in met vervanging en impact.
De twee vormen bestaan naast elkaar tijdens het geïnformeerde venster.
Documentatie en antwoorden identificeren het beëindigde contract.
Afhaling vindt uitsluitend plaats op de aangekondigde datum.