Desenvolvimento de Software · Intermediário · Inglês · Técnico
API versioning
Prática de publicar mudanças de uma API em versões numeradas, como v1 e v2, para que quem já integrou continue funcionando enquanto migra.
Onde usar
'A mudança quebra contrato, então vai para a v2', 'a versão fica na URL ou no header'.
Exemplos
API versioning lets old clients keep working during the migration.
O versionamento de API deixa os clientes antigos funcionando durante a migração.
We put the version in the URL, like /v2/orders.
Colocamos a versão na URL, como em /v2/orders.
Cuidado
Versionar não substitui comunicar: sem aviso e prazo para desativar as versões antigas, a API acumula versões impossíveis de manter.
Sinônimos
versionamento de API