Saltar para o conteúdo

Limites de pedidos

A API tem tectos. O que fazer quando levas um 429, e como escrever um cliente que não os encontra.

Avançado4 min de leitura

Onde há limites

Em três sítios, com propósitos diferentes:

OndeProtegeNotas
Autenticaçãocontra tentativas de credenciaisO mais apertado de todos, de propósito.
API em geralcontra um cliente a monopolizarPor credencial.
Sondas de rede (testar origem, preflight)contra a plataforma virar scannerUm orçamento partilhado pelas duas: separá-las deixava alternar entre elas e duplicar a taxa real.

Isto é distinto do limite de pedidos que configuras num site — esse aplica-se aos visitantes do teu site, não a ti a chamar a API.

O que fazer com um 429

Espera e tenta outra vez, com recuo exponencial. Se a resposta indicar quanto tempo esperar, respeita-o; se não, duplica o intervalo a cada tentativa, com um limite.

async function comRecuo(pedido, tentativas = 5) {
  for (let i = 0; i < tentativas; i++) {
    const res = await pedido()
    if (res.status !== 429) return res

    // Um pouco de aleatoriedade: sem ela, vários clientes que levaram 429
    // ao mesmo tempo voltam todos ao mesmo tempo, e voltam a levar.
    const espera = Math.min(2 ** i * 1000, 30_000) * (0.5 + Math.random())
    await new Promise(r => setTimeout(r, espera))
  }
  throw new Error('limite de pedidos: desisti depois de recuar')
}

A aleatoriedade não é um detalhe. Sem ela, todos os clientes que levaram 429 no mesmo instante voltam no mesmo instante — e voltam a levar, em vaga.

Como não os encontrar

Não faças um pedido por item. Se precisas dos dados de cinquenta sites, pede a lista uma vez e trabalha sobre ela.

Guarda o que não muda. A lista de sites não muda a cada segundo. Um script que a pede em cada iteração de um ciclo está a gastar orçamento em nada.

Espaça o que é periódico. Um monitor de minuto a minuto raramente precisa de ser de minuto a minuto. Ver o intervalo real de mudança do que estás a observar.

Não sondes num ciclo. Testar a origem ou correr o preflight são operações que fazem a plataforma abrir ligações para fora. Chamá-las em ciclo é o caso que o orçamento partilhado existe para travar.

Se o limite não te chegar

Se tens um caso legítimo que não cabe — uma migração, uma importação grande —, abre um pedido de suporte a explicar o que precisas de fazer e em quanto tempo. É mais rápido do que descobrir o tecto por tentativa e erro.

← Toda a documentação