O que é Versionamento de API?
Prática de publicar mudanças de uma API como uma nova versão, mantendo a versão anterior disponível por um período de transição.
Versionar uma API evita que uma mudança no contrato — como alteração de campo ou formato — obrigue todo sistema já integrado a se adaptar no mesmo instante em que a mudança é publicada. Uma nova versão passa a existir ao lado da anterior, geralmente com prazo definido de disponibilidade, dando tempo pra quem consome a API migrar no próprio ritmo, sem quebra abrupta de compatibilidade.