Límites de tasa (rate limits) de la API y encabezados de cuota
Cuántas solicitudes por minuto permite la API de Omnifox según tu plan y cómo leer los encabezados de cuota.
Mira este paso en el video · Paginación y límites
Para proteger la plataforma de abusos y garantizar buen desempeño para todos, cada organización tiene un límite de solicitudes por minuto (rate limit) a la API, según su plan de suscripción. El límite aplica por (usuario + organización) o por token, según cómo te autentiques.
Límites por plan
| Plan | Solicitudes / minuto |
|---|---|
| Lite | 300 |
| Conecta | 600 |
| Crece | 1.200 |
| Escala | 2.400 |
| Exclusivo | Sin límite |
Si tu organización usa un plan no reconocido o de prueba, se aplica un tope de seguridad de 300 req/min.
Encabezados de cuota
Cada respuesta exitosa incluye:
X-RateLimit-Limit: el tope de tu plan (solicitudes/minuto).X-RateLimit-Remaining: cuántas solicitudes te quedan en el minuto actual.
Cuando superas el límite, la API responde 429 Too Many Requests con:
Retry-After: segundos que debes esperar antes de reintentar.X-RateLimit-Reset: timestamp Unix en que se reinicia la cuota.
Ejemplo: leer la cuota restante
curl -i -X GET "https://app.omnifox.io/api/v1/contacts" \
-H "Authorization: Bearer TU_TOKEN" | grep -i ratelimit
X-RateLimit-Limit: 600
X-RateLimit-Remaining: 587
Consejos
- Si tu integración hace polling frecuente (por ejemplo, revisar mensajes nuevos), prefiere procesar Webhooks salientes en vez de consultar la API a intervalos cortos: consumes mucho menos cuota.
- Diseña tu cliente para respetar
Retry-Aftercon backoff exponencial en vez de reintentar inmediatamente.
Solución de problemas
- 429 constante aunque tu volumen es bajo: varios procesos o scripts pueden estar compartiendo el mismo usuario/token; cada uno consume del mismo bucket.
- Necesitas más cuota: sube de plan desde Configuración > Facturación; el límite se recalcula automáticamente en el siguiente minuto.
Artículos relacionados
-
Cómo conectar integraciones y apps externas
Conecta Omnifox con tus herramientas favoritas desde el catálogo de integraciones en pocos pasos.
-
Guía completa de integraciones y API
Integraciones y API a fondo, en 30 capítulos: claves API, llamadas reales, webhooks firmados, n8n, MCP y SDK, todo funcionando de verdad.
-
Integrar Omnifox con Azur, Siigo, Alegra, QuickBooks u otro sistema contable o ERP
Omnifox no tiene hoy un conector nativo con sistemas contables o ERP. Te explicamos cómo conectarlos igual con workflows, el nodo HTTP, n8n, Make, Zapier o la API, con ejemplos.
-
Generar y usar API keys y webhooks
Crea claves de API para acceder a Omnifox por código y configura webhooks para recibir eventos en tiempo real.
-
Introducción a las integraciones (webhook / OAuth / API key)
Conecta Omnifox con tus otras herramientas: qué está disponible hoy, qué llega pronto y cuándo usar un webhook, una conexión OAuth o una clave de API.