Límites de uso
Para evitar abusos, cada cuenta tiene un límite de frecuencia compartido entre todos sus tokens. Mientras tus llamadas se mantengan dentro de ese límite, el uso de la API no tiene restricciones.
Límite de frecuencia (por cuenta)
El límite de frecuencia se aplica por cuenta y es compartido entre todos los API tokens de esa cuenta: crear más tokens no aumenta el límite. Se controla en varias ventanas de tiempo; si se supera el máximo en cualquiera de ellas, las llamadas siguientes son rechazadas hasta que la ventana se renueva.
| Ventana | Máximo de peticiones |
|---|---|
| Por segundo | 10 |
| Por minuto | 100 |
| Por hora | 3000 |
| Por día | 20000 |
Headers de la respuesta
En toda respuesta de la API, el servidor incluye estos headers para que tu integración conozca el estado de su cuota sin tener que adivinarlo.
| Header | Descripción |
|---|---|
X-RateLimit-Limit | Máximo de peticiones permitidas en la ventana. |
X-RateLimit-Remaining | Peticiones que quedan disponibles en la ventana actual. |
X-RateLimit-Reset | Momento en que la ventana actual se reinicia. |
Retry-After | Solo en la respuesta de error 429: cuántos segundos hay que esperar antes de reintentar. |
Cuando se supera el límite
Si se supera el límite de frecuencia, la API responde con el código HTTP 429 Too Many Requests. La integración debe esperar y reintentar más tarde.
HTTP/1.1 429 Too Many Requests
{
"success": false,
"error": "API rate limit exceeded. Please slow down.",
"code": "RATE_LIMITED"
}Buenas prácticas
- Espaciá las peticiones; evitá ráfagas innecesarias.
- Ante un 429, respetá el header
Retry-After—te dice exactamente cuántos segundos esperar—; si no estuviera, aplicá una espera progresiva (backoff exponencial) antes de reintentar. - Para sincronizar muchos registros, usá las operaciones en lote (bulk) en vez de una petición por registro.
- Pedí solo los campos que necesitás con el parámetro fields para respuestas más livianas.
- Cacheá del lado de tu integración los datos que no cambian seguido.
¿Necesitás un límite más alto?
Si tu integración necesita un límite de frecuencia más alto que el de tu cuenta, contactá a soporte para evaluar un plan superior o un límite personalizado acorde a tu volumen de uso.