Vai al contenuto

Breaking change

Una modifica che impedisce a consumatori o usi prima supportati di funzionare come concordato.

Noto anche comeModifica incompatibile
Architettura software

Un impegno esistente cambia in modo incompatibile

Un breaking change altera un contratto supportato imponendo l’adattamento ai consumatori o facendo perdere il comportamento concordato. Può riguardare formato dei dati, input obbligatori o significato di un risultato.

In un esempio inventato, un’API degli interventi rimuove il campo orderId prima promesso. Un rapporto che ne dipende non può più identificare l’intervento. Un cambio di nome interno senza effetto sul contratto pubblico non sarebbe tale rottura. Verifichi consumatori coinvolti, transizione e comunicazione prima del rilascio. Un nuovo numero di versione non adatta il consumatore. Anche un formato di risposta invariato può contenere un cambiamento aziendale incompatibile.

Fonti