MailingCore
DocumentacionAplicacion de cuota

Aplicacion de cuota

Aviso al 80 %, gracia al 110 % y bloqueo 429.

Las cuotas mensuales de email se aplican en cada envio (POST /emails/send, batch, campanas). Esta pagina explica la escalera de enforcement; ver Planes para limites por tier.

Escalera de enforcement

Uso (% del limite del plan)EnvioHeaders de respuesta
0 – 79 %PermitidoX-Quota-Limit, X-Quota-Used, X-Quota-Percentage
80 – 100 %PermitidoLo anterior + X-Quota-Warning: true
100 – 110 %Permitido (periodo de gracia)Headers de aviso activos
> 110 %BloqueadoHTTP 429 Too Many Requests
X-Quota-Limit: 5000
X-Quota-Used: 4200
X-Quota-Percentage: 84
X-Quota-Warning: true

Que cuenta hacia la cuota

  • Encolado exitoso de envios transaccionales y fan-out de campanas
  • Cada destinatario en un batch cuenta como un email

Los fallos antes del encolado pueden no consumir cuota; revisa GET /emails/logs.

Cuando recibes 429

{
  "statusCode": 429,
  "message": "Monthly email quota exceeded"
}

Opciones:

  1. Mejorar plan — POST /billing/checkout con planSlug superior
  2. Esperar — la cuota se reinicia al inicio del siguiente ciclo (tras invoice.paid en Stripe)
  3. Monitorizar — GET /billing/subscription y widgets del panel

Checklist de integracion

  • Lee X-Quota-Percentage en cada respuesta de envio
  • Alerta a ops cuando aparezca X-Quota-Warning
  • Reduce ritmo o encola envios al acercarte al 100 %
  • Maneja 429 con reintento exponencial tras reinicio de ciclo o upgrade

Relacionado