«Demasiadas tentativas.» e erro 429 (rate_limited)

Sintoma

A página mostra «Demasiadas tentativas. Aguarde um momento e tente de novo.», ou uma integração recebe 429 rate_limited com o cabeçalho Retry-After.

Causa

O serviço limita o número de pedidos por rede, por conta e por cliente, para travar ataques de força bruta e abusos. Acontece, por exemplo:

• depois de muitas palavras-passe ou códigos errados seguidos;
• quando muitos pedidos saem da mesma rede (por exemplo, um escritório inteiro atrás do mesmo endereço a tentar ao mesmo tempo);
• quando uma integração ultrapassa o seu orçamento (por exemplo, 120 criações de pedidos por minuto).

Solução

• Pessoas: espere um minuto e tente de novo, com calma. Não repita muitas vezes seguidas.
• Integrações: espere o número de segundos indicado em Retry-After antes de repetir, com espera exponencial e variação aleatória. Os SDKs fazem-no por si.
• Códigos de uso único: a partir do quinto código errado seguido, o método fica em pausa (de um minuto até uma hora).

Quando escalar

Se o erro aparece a muitas pessoas da mesma rede ao mesmo tempo sem razão aparente, ou se uma integração o recebe mesmo dentro dos limites documentados, contacte o suporte com a hora e o endereço de rede de origem. Muitos 429 numa conta podem indicar uma tentativa de ataque: avise a segurança.