Evoluzione compatibile, migrazioni esplicite.
La versione principale è nell'URL. Le modifiche aggiuntive entrano nella v1 senza interrompere i client; Le modifiche incompatibili richiedono una nuova versione e una finestra di migrazione.
Cosa potrebbe cambiare nella versione v1
Ulteriori operazioni e funzionalità potrebbero essere pubblicate.
I client dovrebbero ignorare le proprietà sconosciute nelle risposte.
Gli abbonamenti con * possono avere tipi aggiunti al catalogo.
Le enumerazioni aperte possono ottenere stati o fornitori documentati.
Cosa richiede una nuova versione
L'endpoint, il campo o il valore esistente non scompaiono silenziosamente.
Semantica, unità o formato incompatibili richiedono un nuovo contratto.
Un campo facoltativo non diventa obbligatorio all'interno della stessa versione.
Le modifiche di autorizzazione incompatibili ricevono la propria migrazione.
Ciclo di ammortamento
Il cambiamento entra nella storia con sostituzione e impatto.
Le due forme coesistono durante la finestra informativa.
La documentazione e le risposte identificano il contratto interrotto.
La rimozione avviene solo nella data annunciata.