# ¿Cómo se manejan las versiones de la API y los cambios que rompen la compatibilidad?

Desarrolle sobre el documento OpenAPI canónico y registre la versión del contrato utilizada por su integración. La política de ciclo de vida aprobada conserva el comportamiento de legacy hasta que se midan los usos, se notifique al cliente y se complete el período de migración. Antes de actualizar, compara esquemas y ejemplos, ejecuta pruebas de contrato para respuestas exitosas y de error, y mantén un camino de deshacer cambios. La publicación sigue controlada por la puerta de liberación compartida.

## Guía canónica

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