Skip to main content
Três contagens independentes, todas em janelas de um minuto. Exceder qualquer uma devolve 429. O limite por credencial é o que você encontra primeiro, então planeje a integração por ele. Ele é aplicado antes da autenticação: requisições com segredo inválido também consomem o limite.

​
O corpo de um 429

​
Como reagir

Espere o que o Retry-After manda esperar. Toda resposta 429 traz esse cabeçalho, em segundos: é o tempo exato até a janela virar, e adivinhar um intervalo só chega antes da hora ou tarde demais. Se o 429 for frequente e não pontual, reduza a taxa de envio na origem.
Os cabeçalhos RateLimit-* vêm em toda resposta, não só no 429. RateLimit-Remaining é quantas requisições ainda cabem na janela e RateLimit-Reset é quantos segundos faltam para ela virar: dá para desacelerar antes de bater no limite, em vez de reagir depois. Um detalhe: as três contagens escrevem nos mesmos cabeçalhos, e o valor que chega até você é o da última a correr, a contagem por organização. Para vigiar o limite por credencial, conte do seu lado.
Repetir é seguro em consultas, não em envios. Em POST /notifications, repetir uma chamada cuja resposta você não recebeu pode emitir uma segunda notificação à mesma pessoa. Use uma Idempotency-Key ou consulte antes de repetir.
Para notificar muitas pessoas de uma vez, o envio em massa por planilha no painel não passa por estes limites. Precisa de um limite maior na API? Fale com o suporte.