Limites de taxa (rate limits) da API e cabeçalhos de cota
Quantas requisições por minuto a API do Omnifox permite conforme seu plano, e como ler os cabeçalhos de cota.
Veja este passo no vídeo · Paginação e limites
Para proteger a plataforma contra abusos e garantir bom desempenho para todos, cada organização tem um limite de requisições por minuto (rate limit) na API, de acordo com seu plano de assinatura. O limite se aplica por (usuário + organização) ou por token, dependendo de como você se autentica.
Limites por plano
| Plano | Requisições / minuto |
|---|---|
| Lite | 300 |
| Conecta | 600 |
| Crece | 1.200 |
| Escala | 2.400 |
| Exclusivo | Sem limite |
Se sua organização usa um plano não reconhecido ou de teste, aplica-se um teto de segurança de 300 req/min.
Cabeçalhos de cota
Toda resposta bem-sucedida inclui:
X-RateLimit-Limit: o teto do seu plano (requisições por minuto).X-RateLimit-Remaining: quantas requisições restam no minuto atual.
Quando você excede o limite, a API responde 429 Too Many Requests com:
Retry-After: segundos que você deve esperar antes de tentar novamente.X-RateLimit-Reset: timestamp Unix em que sua cota é reiniciada.
Exemplo: lendo a cota restante
curl -i -X GET "https://app.omnifox.io/api/v1/contacts" \
-H "Authorization: Bearer SEU_TOKEN" | grep -i ratelimit
X-RateLimit-Limit: 600
X-RateLimit-Remaining: 587
Dicas
- Se sua integração faz polling frequente (por exemplo, verificar mensagens novas), prefira processar Webhooks de saída em vez de consultar a API em intervalos curtos: consome muito menos cota.
- Projete seu cliente para respeitar o
Retry-Aftercom backoff exponencial em vez de tentar novamente de imediato.
Solução de problemas
- 429 constante mesmo com volume baixo: vários processos ou scripts podem estar compartilhando o mesmo usuário/token; todos consomem do mesmo bucket.
- Precisa de mais cota: faça upgrade do plano em Configurações > Faturamento; o novo limite entra em vigor automaticamente no minuto seguinte.
Artigos relacionados
-
Como conectar integrações e apps externos
Conecte o Omnifox às suas ferramentas favoritas a partir do catálogo de integrações em poucos passos.
-
Integrar o Omnifox com Azur, Siigo, Alegra, QuickBooks ou outro sistema contábil ou ERP
O Omnifox não tem hoje um conector nativo com sistemas contábeis ou ERP. Veja como fazer essa conexão mesmo assim com fluxos de trabalho, o nó HTTP, n8n, Make, Zapier ou a API, com exemplos.
-
Guia completo de integrações e API
Integrações e API a fundo, em 30 capítulos: chaves de API, chamadas reais, webhooks assinados, n8n, MCP e SDKs, tudo funcionando de verdade.
-
Gerar e usar API keys e webhooks
Crie chaves de API para acessar o Omnifox por código e configure webhooks para receber eventos em tempo real.
-
Introdução às integrações (webhook / OAuth / chave de API)
Conecte o Omnifox às suas outras ferramentas: o que está disponível hoje, o que chega em breve e quando usar um webhook, uma conexão OAuth ou uma chave de API.