Versionamento
O que pode mudar na v1 e o que nunca muda.
v1 হিমায়িত: কোনো ক্ষেত্র হারায় না বা ধরন বদলায় না; যা আসে নতুন ক্ষেত্র বা রিসোর্স, OpenAPI ও রিলিজ নোটে নথিভুক্ত।
A regra da v1
- Campo publicado não some nem muda de tipo.
- Recurso publicado não muda de endereço nem de ordem de listagem.
- O que chega é aditivo: campo novo, parâmetro opcional novo, recurso novo. Seu código deve ignorar campo que não conhece.
- Mudança que quebra vira /v2, com a v1 no ar durante a transição e aviso no Histórico da API.
Versão do contrato hoje
v1.2.0 O openapi.json declara a versão em info.version; o SDK gerado carrega a mesma versão.