# Limites de taxa e versionamento

Trate `/v1` como o contrato de caminho atual e utilize cabeçalhos de resposta em vez de limites de pedido codificados.

As respostas autenticadas expõem `x-ratelimit-limit`, `x-ratelimit-remaining` e `x-ratelimit-reset`; algumas rotas protegidas também podem devolver `Retry-After`. Um valor limite pode ser dinâmico ou reportado como `unlimited`.

1. Registe o estado, o código de erro e `x-request-id`.
2. No `429`, aguarde até `Retry-After` ou `x-ratelimit-reset` quando presente.
3. Tente novamente com a espera exponencial, o jitter, o atraso máximo e a contagem máxima de ensaios.
4. Limite a simultaneidade do cliente em vez de iniciar uma tempestade de novas tentativas.
5. Não tente novamente o trabalho não idempotente, a menos que a rota documente um comportamento de repetição seguro.

Mantenha o `/v1` no caminho base e teste as migrações em relação à documentação antes de a alterar; nenhum cabeçalho de versão pública alternativo é exigido pelas rotas atuais.

**Resultado esperado:** os clientes recuperam de limites transitórios sem trabalho duplicado e falham claramente em caminhos incompatíveis.