Límites de frecuencia de la API
En Vivoldi, aplicamos límites de llamadas a la API según tu plan para garantizar que todos disfruten de la mejor experiencia posible.
Si superas el límite, verás un error HTTP 429 (Too Many Requests). ¡No te preocupes! Solo espera un poco y vuelve a intentarlo más tarde.
Límites de Solicitudes API por Plan
La siguiente tabla muestra los límites de solicitudes API por minuto y por hora según cada plan disponible.
El volumen de solicitudes permitido puede variar según la escala del servicio y los patrones de tráfico, y se aplican políticas de limitación para garantizar un rendimiento estable y confiable de la API.
| Plan | Máx por minuto | Máx por hora | API de estadísticas / min | API de estadísticas (simultáneo) |
|---|---|---|---|---|
| Gratis | 30 | 600 | 5% del límite base | — |
| Personal | 180 | 10,000 | 5% del límite base | 1 |
| Premium | 300 | 15,000 | 5% del límite base | 1 |
| Empresas | 480 | 25,000 | 5% del límite base | 2 |
| Business Plus | 768 | 40,000 | 5% del límite base | 2 |
| Enterprise | 1,200 | 60,000 | 5% del límite base | Según el contrato (predeterminado: 3) |
Cómo Gestionar los Límites de Solicitudes API Excedidos
Si se supera el límite de solicitudes API, el servidor devolverá una respuesta HTTP 429 (Too Many Requests).
Para garantizar un funcionamiento estable y confiable del servicio, recomendamos implementar la lógica de solicitudes utilizando las siguientes estrategias.
1. Implementar Lógica de Reintento (Retry with Backoff)
Cuando recibas una respuesta 429, espera un breve período antes de volver a enviar la solicitud.
En lugar de realizar solicitudes repetidas en intervalos cortos, se recomienda utilizar una estrategia de Exponential Backoff.
2. Optimizar la Frecuencia de Solicitudes
Si los mismos datos se solicitan repetidamente, puedes reducir llamadas API innecesarias utilizando mecanismos de caché.
Para operaciones de gran volumen, el procesamiento por lotes suele ser más eficiente que realizar solicitudes individuales una por una.
3. Prepararse para Entornos de Alto Volumen
Si tu entorno se acerca con frecuencia al límite de solicitudes API, considera actualizar a un plan superior o utilizar los planes Business Plus y Enterprise con límites más flexibles.
Límites flexibles para Business Plus y Enterprise
Los planes Business Plus y Enterprise utilizan un modelo flexible de escalado API en el que los límites de solicitudes aumentan automáticamente según el volumen mensual de enlaces creados, en lugar de depender de límites fijos.
Este modelo es ideal para plataformas de marketing, servicios eCommerce y sistemas empresariales que gestionan grandes volúmenes de enlaces, ofreciendo flexibilidad para entornos con alto tráfico.
- Base estándar: 10,000 enlaces al mes
- Para garantizar la estabilidad del servicio, la expansión máxima está limitada a 3.5 veces el límite base.
Ejemplo (Plan Enterprise)
- 10,000 enlaces/mes → 1,200 veces por min / 60,000 veces por hora
- 30,000 enlaces/mes → 2,000 veces por min / 100,000 veces por hora
※ Los límites de Webhook son el 80% de los límites de la API general.
※ El límite real puede variar según el contrato. Si necesita una capacidad mayor, contáctenos.