Wortic

Wortic Leilões / Guias

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

RespostaQuandoO que o seu código faz
429 limitePassou de 60 no minutoEspera os segundos do retry-after e tenta de novo
429 bloqueadoInsistiu acima do limitePara tudo até passar o retry-after
403 banidoInsistiu depois de bloqueiosPara 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