Limitación de velocidad
La API de Socios (Partner API) aplica límites de velocidad (rate limits) para garantizar un uso justo y la estabilidad de la plataforma.
Límites predeterminados
| Endpoint | Límite (Producción) | Límite (Sandbox) |
|---|---|---|
| Endpoints generales | 100 solicitudes/min | 500 solicitudes/min |
Creación de pedidos (POST /orders) | 10 solicitudes/min | 50 solicitudes/min |
Encabezados de respuesta
Cada respuesta de la API incluye información sobre los límites de velocidad en los siguientes encabezados:
| Encabezado | Descripción |
|---|---|
X-RateLimit-Limit | Número máximo de solicitudes permitidas en la ventana actual |
X-RateLimit-Remaining | Número de solicitudes restantes en la ventana actual |
X-RateLimit-Reset | Marca de tiempo Unix (segundos) de cuándo se reinicia la ventana de límite de velocidad |
Manejo de respuestas 429
Cuando excede el límite de velocidad, la API devuelve una respuesta 429 Too Many Requests:
{
"statusCode": 429,
"message": "Rate limit exceeded. Try again in 45 seconds.",
"error": "Too Many Requests"
}
Estrategia recomendada
- Lea el encabezado
X-RateLimit-Remainingpara monitorear su uso de forma proactiva. - Cuando reciba un
429, espere hasta el momento indicado porX-RateLimit-Resetantes de reintentar. - Implemente un retroceso exponencial (exponential backoff) para los reintentos y así evitar limitaciones repetidas.
- Almacene en caché las respuestas del catálogo de productos cuando sea posible para reducir solicitudes innecesarias.