Distinguer ajout et rupture
Ajouter un champ ne casse rien. Renommer ou supprimer un champ, changer un format de date : là, les applications existantes risquent de tomber. Seules ces ruptures justifient une nouvelle version.
Annoncer, accompagner, retirer
Une ancienne version reste disponible le temps que les clients migrent. La documentation indique la date de retrait. Les journaux montrent qui l’utilise encore.
Tester le contrat
Des tests de contrat vérifient que l’API respecte ce qu’elle promet. C’est une pratique de base de notre offre back-end & API, détaillée dans une bonne API commence par un contrat clair.