Rate-Limit endpoint contribuintes/DFe/

Contribuinte API Nacional
1

Olá, pessoal. Bom dia! Tudo bem?

Estou recebendo diversos retornos “429 Too Many Requests” ao consultar o endpoint:

https://adn.nfse.gov.br/contribuintes/DFe/{nsu}

Poderiam, por favor, esclarecer o rate limit e as regras de validação aplicadas?

Dúvidas objetivas

  1. A limitação é controlada por IP, por certificado digital ou por outro critério?

  2. Qual é o volume máximo de solicitações permitido (por minuto/hora/dia)?

  3. Há janelas deslizantes ou burst limits (p. ex., X requisições em Y segundos)?

  4. Existem códigos de resposta ou headers (ex.: X-RateLimit-Remaining, Retry-After) que orientem o reenvio?

Cenário

  • Operamos um SaaS com 200k+ CNPJs consultando o DFe.

  • Mesmo consultando por faixa de NSU (inicial → final) diária (1x por CNPJ a cada 24h), o número de requisições varia conforme a disponibilidade de documentos e a quantidade de CNPJs, concentrando um volume relevante de chamadas a partir do mesmo IP.

Desde já, obrigado!