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 oRetry-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.
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.
Percorrendo uma listagem
GET /notifications e GET /templates contam requisições, não linhas. Uma página de 50 e uma de
10 custam exatamente o mesmo, então, para percorrer um histórico, peça limit=50 e não o padrão de
10: é a diferença entre gastar uma requisição a cada 50 linhas e uma a cada 10.
Muitas chamadas pequenas e seguidas é o jeito mais fácil de bater no limite por credencial sem estar
enviando nada.
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.