Conceptos
Rate limits
Para proteger la plataforma multi-tenant, SELLERP enforce un límite de 500 requests/minuto por organización compartido entre la API REST y el MCP.
Cuotas vigentes
- 500 requests / minuto por organización (no por API key).
- Compartido entre API REST + MCP. Si tu MCP-bot consume mucho, deja menos cuota para tu script de export.
- 200 filas máximas por respuesta de listado. Pagina si necesitas más.
- 15 segundos de timeout por request.
Headers de cuota
Cada respuesta incluye:
| Header | Significado |
|---|---|
X-RateLimit-Limit | Cuota total en la ventana actual |
X-RateLimit-Remaining | Cuántos requests te quedan |
X-RateLimit-Reset | Epoch seconds en que la ventana se resetea |
Cuando recibes 429
- Lee el header
Retry-After(segundos). - Espera al menos ese tiempo. Idealmente añade jitter aleatorio.
- Reintenta el mismo request. Si vuelve a fallar, duplica la espera (max 30s).
Cuándo subir tu plan
Si pegas el techo de 500 req/min consistentemente, lo más probable es que estés sobre-polleando. Antes de subir de plan, revisa:
- ¿Estás usando
updated_sincepara delta-sync? Eso reduce dramáticamente la carga. - ¿Estás cacheando los
GET /v1/me? Solo necesitas pegarlo cada vez que cambias de plan. - ¿Estás polleando endpoints muy frecuentes (cada 30 seg) cuando un cron de 15 min es suficiente?
Si después de optimizar sigues necesitando más, escríbenos a soporte@sellerp.com. Para volúmenes corporativos existe el plan Experto con cuotas a medida.