Limites de pedidos
A API tem tectos. O que fazer quando levas um 429, e como escrever um cliente que não os encontra.
Onde há limites
Em três sítios, com propósitos diferentes:
| Onde | Protege | Notas |
|---|---|---|
| Autenticação | contra tentativas de credenciais | O mais apertado de todos, de propósito. |
| API em geral | contra um cliente a monopolizar | Por credencial. |
| Sondas de rede (testar origem, preflight) | contra a plataforma virar scanner | Um 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.