La suppression d'un champ ou la modification de sa signification peut interrompre les clients qui se déploient selon un calendrier différent. Une migration par étapes permet aux consommateurs de se déplacer sans obliger chaque appelant à changer en même temps.
Ajouter avant de supprimer
- Introduisez le champ ou le point de terminaison de remplacement tout en préservant l’ancien contrat.
- Documentez la transition et donnez aux clients un exemple concret de migration.
- Mesurez l’utilisation de l’ancien chemin sans collecter d’informations personnelles inutiles.
Prendre une décision de suppression
Choisissez une date de fin ou un seuil d'utilisation réaliste pour les clients que vous soutenez. Informez les consommateurs connus, publiez un dernier rappel et supprimez l'ancien comportement uniquement lorsque le plan de compatibilité indique qu'il est sûr.
Testez les anciens et les nouveaux clients pendant la transition. Si l'API est publique, tenez compte des clients que vous ne pouvez pas contacter directement et suivez la politique de versionnage ou de dépréciation sur laquelle vos utilisateurs s'appuient déjà.