Documentation Index
Fetch the complete documentation index at: https://docs.engineapi.com.br/llms.txt
Use this file to discover all available pages before exploring further.
Rate Limits
A Engine API aplica limites de taxa para garantir estabilidade e performance para todos os parceiros. Os limites são aplicados por API Key.Limites por plano
| Plano | Requests/minuto | Requests/hora | Emissões/mês |
|---|---|---|---|
| Starter | 60 | 1.000 | 500 |
| Professional | 100 | 5.000 | 5.000 |
| Enterprise | 300 | 15.000 | Ilimitado |
Limites de emissão são contados por documento fiscal autorizado (NFe, NFCe, CTe, MDFe, NFSe). Consultas e downloads não contam para esse limite.
Headers de rate limit
Toda resposta da API inclui headers que indicam seu consumo atual:| Header | Descrição |
|---|---|
X-RateLimit-Limit | Total de requests permitidos no período |
X-RateLimit-Remaining | Requests restantes no período atual |
X-RateLimit-Reset | Timestamp Unix de quando o contador reseta |
Resposta 429 (Too Many Requests)
Quando o limite é atingido, a API retorna:Retry com backoff exponencial
Implemente retry automático para lidar com rate limits de forma elegante:- TypeScript
- Python
- PHP
Boas práticas
Monitore os headers
Monitore os headers
Verifique
X-RateLimit-Remaining em cada resposta. Se estiver abaixo de 10%, reduza a velocidade das chamadas proativamente.Use filas para emissão em lote
Use filas para emissão em lote
Se precisa emitir muitas notas de uma vez, use uma fila (Bull, RabbitMQ, SQS) com intervalo entre emissões ao invés de chamadas paralelas.
Separe consultas de emissões
Separe consultas de emissões
Consultas (GET) e downloads (PDF/XML) são mais leves que emissões (POST). Se possível, faça consultas em horários de menor movimento.
Cache respostas de consulta
Cache respostas de consulta
O status de uma NFe autorizada não muda. Cache o resultado de
GET /v1/nfe/:id para evitar chamadas repetidas.Endpoints isentos
Alguns endpoints não contam para o rate limit:| Endpoint | Motivo |
|---|---|
GET /health | Health check de monitoramento |
GET /v1/nfe/status | Status do SEFAZ |
GET /v1/nfe/pdf/:key | Download de PDF (cache CDN) |
GET /v1/nfe/xml/:key | Download de XML (cache CDN) |
Precisa de mais?
Se o seu volume ultrapassa os limites do plano Professional, entre em contato para um plano Enterprise personalizado:- Email: suporte@engineapi.com.br
- Dashboard: app.engineapi.com.br