¿En qué cambios de respuesta de la API debemos aumentar la versión y en cuáles no?

La versión de la API debe aumentarse cuando se realicen cambios que rompan la compatibilidad hacia atrás (cambios disruptivos). Estos cambios incluyen:

• Eliminar o renombrar campos existentes en la respuesta.
• Cambiar el tipo de datos de los campos.
• Cambiar la estructura de la respuesta, lo que impide que los clientes procesen correctamente los datos.

Los cambios que no requieren aumentar la versión:

• Agregar nuevos campos opcionales en la respuesta (los clientes pueden ignorarlos).
• Agregar nuevos endpoints.
• Corregir errores que no afectan la estructura y el formato de la respuesta.

Por lo tanto, si los cambios pueden romper a los clientes existentes, es necesario aumentar la versión de la API.