# Comment les versions d'API et les changements brisants sont-ils gérés ?

Construisez sur le document OpenAPI canonique et enregistrez la version du contrat utilisée par votre intégration. La politique de cycle de vie approuvée préserve le comportement hérité jusqu'à ce que les mesures d'utilisation, l'avis aux clients et la période de migration soient terminées. Avant de mettre à jour, comparez les schémas et les exemples, exécutez des tests de contrat pour les réponses réussies et les erreurs, et maintenez un chemin de retour en cas d'échec. La publication reste contrôlée par la porte d'entrée commune de diffusion.

## Guidance canonique

- /api-documentation
- /openapi/openapi.json