Versionado
Se utiliza path-based versioning: /api/v1/....
Política
- Cambios compatibles (campos nuevos opcionales, valores nuevos en enums) → sin cambio de versión.
- Cambios incompatibles (renombrar campos, cambiar tipos, eliminar) → nueva versión
/api/v2/. - Deprecation: se anuncia con 90 días de antelación en el changelog y vía email a los administradores.
Compromiso
v1se mantendrá soportado al menos 24 meses desde el anuncio dev2.- Durante ese periodo, recibe bugfixes pero no nuevas features.