MailingCore
DocumentazioneApplicazione quota

Applicazione quota

Avviso all'80 %, grazia al 110 % e blocco 429.

Le quote mensili email si applicano a ogni invio (POST /emails/send, batch, campagne). Questa pagina spiega la scala di enforcement; vedi Piani per i limiti per tier.

Scala di enforcement

Utilizzo (% del limite piano)InvioHeader risposta
0 – 79 %ConsentitoX-Quota-Limit, X-Quota-Used, X-Quota-Percentage
80 – 100 %ConsentitoSopra + X-Quota-Warning: true
100 – 110 %Consentito (periodo di grazia)Header avviso attivi
> 110 %BloccatoHTTP 429 Too Many Requests
X-Quota-Limit: 5000
X-Quota-Used: 4200
X-Quota-Percentage: 84
X-Quota-Warning: true

Cosa conta verso la quota

  • Accodamento riuscito di invii transazionali e fan-out campagne
  • Ogni destinatario in un batch conta come un'email

I fallimenti prima dell'accodamento potrebbero non consumare quota; controlla GET /emails/logs.

Quando ricevi 429

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

Opzioni:

  1. Upgrade — POST /billing/checkout con planSlug superiore
  2. Attendere — la quota si resetta all'inizio del ciclo successivo (dopo invoice.paid su Stripe)
  3. Monitorare — GET /billing/subscription e widget del pannello

Checklist integrazione

  • Leggi X-Quota-Percentage su ogni risposta di invio
  • Avvisa ops quando compare X-Quota-Warning
  • Riduci ritmo o accoda invii avvicinandoti al 100 %
  • Gestisci 429 con retry esponenziale dopo reset ciclo o upgrade

Correlati