Versionado - CUCU API

Versión actual

La API usa versionado en la URL:

/api/v1/

Todos los endpoints actuales están bajo /api/v1/.

Política de cambios

Tipo de cambio	Qué hacemos
Nuevo endpoint	Se agrega bajo `/api/v1/` sin aviso previo requerido
Nuevo campo en response	Se agrega bajo `/api/v1/` — backwards compatible
Campo nuevo requerido en request	Se anuncia con anticipación, luego `/api/v2/`
Cambio en comportamiento existente	Se anuncia con anticipación, luego `/api/v2/`
Eliminación de campo o endpoint	Se depreca primero, luego `/api/v2/`

Los cambios breaking se anuncian por email a todos los titulares de API Key con al menos 60 días de anticipación antes de introducir una nueva versión.

Múltiples versiones activas

Cuando exista /api/v2/, la versión /api/v1/ permanecerá activa durante un período de transición mínimo de 6 meses para permitir la migración sin interrupciones.