Limites de uso
Os limites protegem a plataforma e a comunicação com a Sefin Nacional.
| Limite | Valor |
|---|---|
| Requisições por chave de API ou token OAuth | 300 a cada 5 minutos |
| Requisições por endereço IP | 300 a cada 5 minutos |
Leitura de uma nota (GET /invoices/:id, get_invoice) |
60 por minuto |
| DANFSe | 30 por minuto |
| Consulta de CEP | 30 por minuto |
Consulta de CNPJ (lookup_company) |
20 por minuto |
| Entrar (por IP e por e-mail) | 5 por minuto |
Cabeçalhos
As respostas da API, do servidor MCP e do OAuth trazem o limite mais próximo de acabar:
RateLimit-Limit: 300
RateLimit-Remaining: 287
RateLimit-Reset: 112
RateLimit-Policy: 300;w=300
RateLimit-Reset: segundos até a janela recomeçar.RateLimit-Policy: limite e janela (w) em segundos.
Resposta 429
HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json
Retry-After: 112
{ "title": "Muitas requisições. Tente novamente em alguns minutos.", "status": 429, "code": "rate_limited", "errors": [] }
Espere os segundos de Retry-After antes de tentar de novo. Para acompanhar a emissão, prefira webhooks a consultas repetidas.