Aller au contenu

Changement incompatible

Un changement qui empêche des consommateurs ou usages pris en charge de fonctionner comme convenu.

Également appeléBreaking Change
Architecture logicielle

Un engagement existant change de façon incompatible

Un changement incompatible modifie un contrat pris en charge au point d’imposer l’adaptation des consommateurs ou de leur faire perdre le comportement convenu. Il peut toucher format des données, entrées obligatoires ou sens d’un résultat.

Dans un exemple fictif, une API d’interventions retire le champ orderId auparavant promis. Un rapport qui en dépend ne peut plus identifier l’intervention. Renommer un élément interne sans effet sur le contrat public ne serait pas une telle rupture. Vérifiez consommateurs concernés, transition et communication avant livraison. Un nouveau numéro de version n’adapte pas le consommateur. Même un format de réponse inchangé peut cacher un changement métier incompatible.

Sources