DocumentacionLimites de peticiones
Limites de peticiones
Throttling, limites de auth y cabeceras X-RateLimit-*.
MailingCore aplica limites de peticiones para proteger la plataforma. Son independientes de la cuota mensual de emails.
Limite global API (produccion)
| Ajuste | Valor |
|---|---|
| Peticiones | 300 por minuto por cliente |
| Ventana | 60 segundos |
| Desarrollo | 1000/min (default) |
Al superar el limite: 429 Too Many Requests.
Endpoints de auth (mas estrictos)
| Ajuste | Valor |
|---|---|
| Peticiones | 15 por 15 minutos |
| Aplica a | POST /auth/login, POST /auth/register, reset password, 2FA |
Cabeceras de respuesta
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 287
X-RateLimit-Reset: 1719820800
| Cabecera | Descripcion |
|---|---|
X-RateLimit-Limit | Max peticiones en la ventana |
X-RateLimit-Remaining | Peticiones restantes |
X-RateLimit-Reset | Timestamp Unix de reinicio |
Buenas practicas
- Backoff en 429 — espera
X-RateLimit-Reseto backoff exponencial. - Envio por lotes — usa POST /emails/batch.
- Cache en dashboard — no hagas polling agresivo de logs.
- Auth server-side — no reintentes
/auth/loginen bucle desde el cliente.
Ver Codigos de error.