1
resposta

URL para novas versões

Seria uma boa prática, deixar a url original sempre com a última versão?

Como no exemplo abaixo da API DiceBear Avatars, sempre que utilizar a url original, o usuário terá acesso a última versão.

Insira aqui a descrição dessa imagem para ajudar na acessibilidade

Achei interessante compartilhar esse padrão utilizado por eles.

[]'s

1 resposta

Oii Luciano, como você está?

Peço desculpas pela demora em obter um retorno.

É considerado sim uma boa prática o uso de uma versão padrão que será apresentada para o usuário de uma API quando a versão não estiver incluída na URL. Além de APIs podemos ver esse comportamento em páginas que contêm a documentação de um framework, tomando como exemplo a documentação do Django, acessando a primeira URL apresentada abaixo, seremos levados para versão mais recente da documentação, nesse momento a versão 4.1.

Já no próximo link, iremos informar que queremos as documentações referentes a versão 3.1 do Django, assim, será necessário acessarmos a URL informando a versão desejada.

O uso de uma versão padrão proporciona uma melhor experiência de usuário, onde será possível acessar a versão atual de uma API sem a necessidade de conhecer previamente qual sua versão mais nova.

Qualquer dúvida fico à disposição.

Abraços e bons estudos!

Caso este post tenha lhe ajudado, por favor, marcar como solucionado ✓. Bons Estudos!

Quer mergulhar em tecnologia e aprendizagem?

Receba a newsletter que o nosso CEO escreve pessoalmente, com insights do mercado de trabalho, ciência e desenvolvimento de software