Aula 11

Question 1

Quais são os dois tipos de versionamento mais utilizados?

Answer 1

Versionamento via URL e via HEADER

Question 2

O que é o versionamento via URL?

Answer 2

Existem 3 tipos de versionamento via URL:

• Por subdomínio. Ex.: v1-sub.com/…
• Por Path Param. Ex.: sub.com/v1/…
• Por Query Param. Ex.: sub.com/…/?version=v1.0

A abordagem considerada mais “amigável” para os devs é o via Path Param, já que é mais organizado e simples de entender.

Query Params já foram bastante utilizadas no passado, mas hoje foram substituídas por dois motivos principais :

1 - Compromete a legibilidade do Path
2 - Acaba ficando mais difícil de se lidar quando a API já tem muitos parâmetros na query string.

Question 3

O que é o versionamento via Header?

Answer 3

Existem 2 formas principais de fazer isso :

1 - Usando o parâmetro ‘Accept’ no cabeçalho HTTP.

2 - Usando um parâmetro customizado no Header, como ‘api-version’, atribuindo apenas o número da versão.