Limites de taxa e versionamento

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.