Você opera uma API de recomendação para clientes de varejo e deve preservar a estabilidade ao fazer alterações incompatíveis com versões anteriores. Qual estratégia de versionamento de API você deve seguir?

Para preservar a estabilidade ao introduzir alterações incompatíveis com versões anteriores, a melhor prática é adotar uma estratégia de versionamento que incremente o número da versão da API. Isso permite que os clientes continuem usando a versão antiga e funcional enquanto se preparam para migrar para a nova versão. Notificar os clientes é importante, mas não impede que a API antiga seja quebrada. Automatizar a documentação é uma boa prática, mas não resolve o problema de compatibilidade. Adicionar 'DEPRECATED' e reutilizar o mesmo número de versão causaria interrupções para os clientes existentes, pois a API que eles usam deixaria de funcionar como esperado sem um caminho de migração claro.