Limites
Limites de peticion, tamano, batch y rate que aplica la API de MailingCore.
MailingCore aplica un conjunto reducido de limites para proteger la entregabilidad y mantener la plataforma justa. Cada uno devuelve un error claro cuando se supera.
Limites de peticion
| Limite | Valor | Al superarse |
|---|---|---|
| Destinatarios por envio batch | 100 | 400 BATCH_LIMIT_EXCEEDED |
| Tamano del mensaje construido | 10 MB | 413 EMAIL_TOO_LARGE |
| Longitud del asunto | 998 caracteres | 400 validacion |
| Contactos por importacion masiva | 1 000 | 400 validacion |
Un batch cuenta cada destinatario contra tu cuota, asi que un batch de 100 usa 100 emails.
Cuota mensual de emails
Cada plan incluye una cuota mensual de emails. El uso se comprueba sobre el uso proyectado — un batch de N cuenta como N por adelantado:
| Uso | Comportamiento |
|---|---|
| < 80% | OK |
| 80–100% | OK + cabecera X-Quota-Warning |
| 100–110% | Periodo de gracia — se envia igual, se avisa al owner |
| > 110% | Bloqueo duro — 429 QUOTA_EXCEEDED |
Cada envio devuelve X-Quota-Limit, X-Quota-Used y X-Quota-Percentage. Ver Planes para las cuotas por plan y Aplicacion de cuota para el detalle.
Rate limits
| Ambito | Limite |
|---|---|
| Peticiones autenticadas | 300 / minuto por usuario |
| Endpoints de auth (login, registro, 2FA, reset de password) | 15 intentos / 15 minutos |
Las peticiones limitadas devuelven 429. Ver Limites de peticiones para cabeceras y reintentos.
Limites de recursos por plan
Dominios, miembros del equipo y plantillas guardadas estan limitados por plan (por ejemplo Free: 1 dominio / 1 miembro / 5 plantillas; Business: 20 / 50 / 500). Ver Planes para la tabla completa.