API Versioning
El versionado de API gestiona los cambios de interfaz para que las nuevas versiones no rompan clientes antiguos, comúnmente mediante ruta URL, cabeceras o parámetros de consulta.
Propósito
Gestionar la evolución de la API, garantizando compatibilidad hacia atrás y migración suave.
Mecanismo
Ruta URL: /v1/users (explícito, simple). Cabecera: Accept: application/vnd.api+json;version=1 (RESTful). Query: ?version=1. Versionado semántico: major rompe compatibilidad, minor añade funciones, patch corrige. Versiones antiguas se deprecian con período de transición.
Casos de uso
- Gestión de API
- Compatibilidad hacia atrás
- Evolución de versiones