Erro 429 no app: como avisar o usuário e tentar de novo sem travar

Quando a API responde 429 Too Many Requests, o app tem duas tarefas: esperar o tempo certo antes de tentar de novo e explicar o que está acontecendo ao usuário. A maioria dos apps falha em uma das duas.

Tentar de novo com inteligência

• Respeite o cabeçalho Retry-After quando presente.
• Sem ele, use espera exponencial com variação aleatória (Gerenciando o erro 429 Too Many Requests: exponential backoff e retry no cliente).
• Limite o número de tentativas.
• Repita automaticamente só operações seguras (Idempotência: como evitar cobrança duplicada e pedidos repetidos).

O que o usuário vê

1. 1.Mensagem humana: "Muitas tentativas seguidas. Tente novamente em 30 segundos."
2. 2.Botão desabilitado com contagem regressiva, que se reativa sozinho.
3. 3.Nada perdido: o que foi digitado continua na tela (Formulários no celular: teclado certo, autofill e máscaras).
4. 4.Sem alertas repetidos a cada falha.

const [espera, setEspera] = useState(0)
useEffect(() => {
  if (espera <= 0) return
  const t = setTimeout(() => setEspera((s) => s - 1), 1000)
  return () => clearTimeout(t)
}, [espera])

<Botao disabled={espera > 0} titulo={espera > 0 ? `Tente em ${espera}s` : 'Enviar'} />

Evite causar o 429

• Debounce em buscas e filtros (Debounce e throttle em inputs: busca rápida sem derrubar a API).
• Cache de respostas e dados locais (Offline-first: apps que continuam funcionando sem internet).
• Não refaça todas as chamadas ao voltar para o app.

Conexão ruim é outra coisa

Diferencie limite de requisições, falta de internet e erro do servidor — cada um pede uma mensagem diferente (Estados vazios e de erro: as telas que ninguém desenha (e todo usuário vê)).

A We Codex desenvolve apps resilientes. Veja aplicativos nativos ou fale com a gente.