Rate limiting

A API limita requisições em duas camadas, e as duas valem ao mesmo tempo.
Estourar qualquer uma delas devolve 429.

A segunda existe porque a primeira, sozinha, não protege: 1.000 chamadas
disparadas em dois segundos cabem no limite de 5 minutos e ainda assim derrubam
a estabilidade. É por isso que uma integração pode tomar 429 mesmo consumindo
bem menos do que a cota do período.

O escopo é a conta, não o token, nem o IP, nem o endpoint. Vários serviços
seus compartilhando a mesma conta dividem o mesmo teto — inclusive integrações
que outra pessoa da equipe configurou.

Ao estourar

HTTP 429 Too Many Requests

Não há retentativa automática. Espere a janela se restabelecer antes de voltar a
chamar — insistir imediatamente só consome a cota da janela seguinte.

Como não chegar lá

Não faça laço sem freio. for e while que disparam chamadas em sequência
são a causa mais comum de 429. Coloque um intervalo entre as iterações, ou
limite quantas correm em paralelo.

Faça retry com espera crescente. Ao receber 429, aguarde e tente de novo
com o intervalo dobrando a cada tentativa. Retry imediato transforma um pico
pontual em bloqueio contínuo.

Prefira uma chamada que traz muitos a muitas que trazem um. Onde o endpoint
aceita filtro ou paginação, uma requisição por página custa muito menos que uma
por registro.

Guarde o que não muda. Etiquetas, equipes, campos personalizados e carteiras
mudam raramente. Buscá-los a cada operação gasta cota à toa — carregue uma vez e
reaproveite.

Se o teto não for suficiente

Se a sua integração precisa legitimamente de mais do que isso, fale com o
suporte antes de tentar contornar. Distribuir a carga por várias contas para
driblar o limite quebra o modelo de isolamento e tende a criar problemas piores
do que o 429.