Versionado

Usamos 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: anunciamos con 90 días de antelación en el changelog y vía email a admins.

Compromiso

• v1 se mantendrá soportado al menos 24 meses desde el anuncio de v2.
• Durante ese periodo, recibe bugfixes pero no nuevas features.