pnclENGINEObter acesso à API

NOTAS DE CAPACIDADE

Por que você leva 429 com orçamento diário sobrando

O teto do plano é por segundo, não por dia. Um loop que dispara todos os boards de uma vez estoura o limite, e o ritmo é a correção de graça.

A aritmética dizia que estava tudo bem: boards sobre intervalo, somados ao longo do dia, bem dentro do plano. Mesmo assim os logs mostram 429s. A confusão vem de misturar os dois medidores. O seu volume diário é contabilidade; o teto que o rejeita é por segundo. Você pode estar rico no primeiro e quebrado no segundo, e a correção é ritmo, não um plano maior.

O teto vigia o segundo, não o dia

Todo plano carrega uma permissão por segundo, e cruzá-la retorna 429 com um cabeçalho Retry-After, como o guia de limites de taxa documenta, verificado em 2026-10-25. Nada nessa resposta pergunta como está o seu mês. Uma rajada que cruza a linha por segundo é rejeitada na hora, mesmo que a rajada seja as únicas mil chamadas do dia.

A forma típica do problema é um loop que acorda num timer e dispara todos os boards de uma vez. Dez esportes, ao vivo e pré-jogo, todos requisitados nos mesmos cem milissegundos: são 20 requisições numa fração de segundo, contra um teto que pode ser de 10 por segundo. O loop então dorme 29 segundos, bem comportado na média, e ainda engole rejeições a cada ciclo.

Ritmo é folga de graça

Espalhe o mesmo trabalho pelo ciclo e a rajada desaparece. Vinte boards num intervalo de 30 segundos, começando um a cada 1,5 segundo, nunca chegam perto do teto, e a contagem diária de requisições é idêntica. O guia de polling nomeia o ritmo uniforme como um dos hábitos que mantêm o volume de requisições plano, e é aqui que o hábito paga: a linha por segundo do plano se comporta como uma permissão muito maior quando a carga é suave.

Dois detalhes fazem o ritmo durar. Adicione um pequeno deslocamento aleatório ao agendamento de cada board para que os ciclos não se alinhem depois de um restart. E mantenha o ritmo no agendador, não no tratador de retry, porque uma tempestade de retries é só uma rajada com passos extras.

Quando é o plano de verdade

Ritmo não corrige um total que está acima da linha. Some os seus boards divididos pelos intervalos, todos os workers incluídos, e compare com a permissão. Se o número honesto excede o teto no seu minuto mais cheio, nenhum suavizamento salva; essa é uma conversa de plano, não de agendamento.

O diagnóstico é a distribuição dos 429. Rejeições concentradas nos começos de ciclo, com segundos quietos entre elas, apontam para rajadas. Rejeições espalhadas uniformemente pelos minutos cheios, num agendamento suave, significam que o total em si é alto demais. As taxas de requisição e de erro do guia de monitoramento mostram as duas visões, verificado em 2026-10-25.

Um reparo de dez minutos

  1. Registre o timestamp de cada requisição por uma hora cheia.
  2. Agrupe-as por segundo e ache o pico.
  3. Se o pico cruza o teto enquanto a média fica bem abaixo, escalone os inícios.
  4. Meça de novo por um dia. A contagem de 429 deve cair para ruído sem nenhum board descartado.

O número diário diz o que você comprou. O número por segundo diz como gastá-lo. Mantenha os dois honestos e os 429s se resolvem sozinhos.