Tratar o 429 e o retry-after sem ser bloqueado
São 60 pedidos por minuto por IP, sem chave. Quem fica abaixo disso nunca é bloqueado, e quem recebe 429 espera o retry-after antes de voltar.
Publicado em .
Fontes oficiais: o Sistema de Leilão Eletrônico da Receita Federal e o Portal Nacional de Contratações Públicas.
A API é aberta e grátis. O limite existe para ela continuar rápida para todo mundo, e a própria resposta diz quanto esperar.
As respostas de limite
| Resposta | Quando | O que o seu código faz |
|---|---|---|
429 limite | Passou de 60 no minuto | Espera os segundos do retry-after e tenta de novo |
429 bloqueado | Insistiu acima do limite | Para tudo até passar o retry-after |
403 banido | Insistiu depois de bloqueios | Para de vez e fala com a Wortic |
O código
export async function consultar(caminho, { tentativas = 2 } = {}) {
for (let i = 0; ; i++) {
const r = await fetch(`https://leiloes.wortic.com${caminho}`);
const corpo = await r.json();
if (r.status !== 429) return { status: r.status, corpo };
if (corpo.erro?.codigo === "bloqueado" || i >= tentativas) return { status: r.status, corpo };
const espera = Number(r.headers.get("retry-after") ?? 60);
await new Promise((ok) => setTimeout(ok, espera * 1000));
}
}
Tente poucas vezes e nunca repita diante de bloqueado ou banido: é o laço que repete sem esperar que leva um IP à escada.
Perguntas e respostas
Qual é o limite da API sem chave?
60 pedidos por minuto por IP. Acima disso a resposta é 429 com o código limite e o cabeçalho retry-after em segundos.
Quando o IP é bloqueado?
Cada minuto em que o IP passa do limite conta uma vez. Com 10 vezes, o IP fica bloqueado por 1 hora. Depois de 3 bloqueios de 1 hora, o seguinte é de 6 horas. Depois de 3 bloqueios de 6 horas, o IP é banido.
Como consultar mais de 60 por minuto?
Com uma chave do plano Pro no cabeçalho x-api-key: vale o limite do plano e a escada de bloqueio não se aplica.
Todos os guias · Documentação com exemplos · openapi.json · Versão para IA