# Versionamento

> Versão no caminho (/v1): o que muda sem aviso, o que só muda numa versão nova e como a API avisa.

URL: https://precificador3d.com.br/docs/api/versionamento

A versão maior vai no caminho: `https://api.precificador3d.com.br/v1`.

## Entra na v1 sem aviso

- Campo novo numa resposta.
- Evento de webhook novo e campo novo em `dados`.
- Valor novo num campo de lista aberta (como `status`).
- Operação nova.

Por isso, o seu código precisa **ignorar o que não conhece**: não quebre com campo novo e trate valor desconhecido com um caminho padrão.

## Só numa versão nova

Tirar ou renomear campo, mudar tipo ou mudar o sentido de algo só acontece em `/v2`, e a `/v1` continua funcionando por **12 meses** depois que a `/v2` sair.

## Como a API avisa

- Cabeçalhos `Deprecation` e `Sunset` nas respostas do que vai sair, com `Link` para esta documentação.
- E-mail ao dono das chaves que usaram o recurso nos últimos 30 dias, 6 meses, 1 mês e 1 semana antes.
- Registro no [changelog](https://precificador3d.com.br/docs/api/changelog).