API Docs v1.0
Rate Limits
Límites de uso de la API y cómo manejarlos.
Límites por defecto
| Plan | Requests/minuto | Requests/día |
|---|---|---|
| Estándar | 60 | 10,000 |
| Profesional | 300 | 50,000 |
| Enterprise | Personalizado | Personalizado |
Headers de respuesta
Cada respuesta incluye headers que indican tu uso actual: ``
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 57
X-RateLimit-Reset: 1708981200
`
Header Descripción X-RateLimit-Limit Máximo de requests por minuto X-RateLimit-Remaining Requests disponibles en la ventana actual X-RateLimit-Reset Timestamp UNIX cuando se reinicia el contador
Cuando excedes el límite
Recibes un 429 Too Many Requests:
`json
{
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Rate limit exceeded. Retry after 45 seconds."
}
}
`
El header Retry-After` indica cuántos segundos esperar.
Buenas prácticas
- Implementa exponential backoff en tu cliente
- Cachea respuestas que no cambian frecuentemente
- Usa paginación para reducir la cantidad de requests
- Monitorea los headers de rate limit para anticipar límites