Vai al contenuto
Docs

Riferimento

Come Emailit limita gli invii per workspace, gli header ratelimit di ogni invio, com’è fatta una risposta 429, gli altri limiti degli endpoint e come ritentare con backoff.

Aggiornato il 19 ott 2026

Emailit limita quanto velocemente e quanto può inviare un workspace, non quante chiamate API fai. Questa pagina spiega i limiti di invio, gli header che li riportano, i pochi endpoint con limiti propri e come applicare il backoff quando ricevi un 429.

Limiti di invio

Ogni workspace ha due limiti di invio. Partono da questi valori:

Limite Partenza Finestra
Al secondo 2 email Finestra mobile di un secondo
Al giorno 100 email con Pay as you go fino al primo acquisto di crediti, poi 5000. 5000 con Pro e Business. Giorno di calendario in UTC, si azzera alle 00:00 UTC

Come si applicano i limiti:

  • Per workspace. Tutte le chiavi API e l’SMTP relay condividono gli stessi contatori. Inviare tramite SMTP consuma la stessa quota dell’API.
  • Conteggio per destinatario. Ogni indirizzo univoco tra to, cc e bcc è un’email. Una richiesta con tre destinatari conta come tre.
  • Contano solo gli invii. I limiti si applicano a Invia un’email e Inoltra un’email. La lettura dei dati e la gestione delle risorse non rientrano nei limiti.
  • L’intera richiesta deve rientrare. Un invio viene accettato solo se tutti i suoi destinatari rientrano in quanto resta del limite di oggi; altrimenti riceve 429 e non viene inviato nulla. I suoi destinatari vengono aggiunti ai contatori dopo che l’email è stata memorizzata.

Puoi vedere i limiti attuali e l’utilizzo di oggi nel riquadro Sending Limits della pagina Dashboard.

Header dei limiti di frequenza

Le risposte degli endpoint di invio e di inoltro includono questi header:

Header Descrizione
ratelimit-limit Le email che il workspace può inviare al secondo.
ratelimit-remaining Le email rimanenti nella finestra di un secondo in corso.
ratelimit-reset I secondi mancanti all’azzeramento della finestra al secondo.
ratelimit-daily-limit Le email che il workspace può inviare al giorno.
ratelimit-daily-remaining Le email rimanenti per oggi.
ratelimit-daily-reset I secondi mancanti all’azzeramento del limite giornaliero alle 00:00 UTC.
retry-after I secondi da attendere prima di ritentare. Inviato solo con le risposte 429.
HTTP
HTTP/1.1 200 OK
content-type: application/json; charset=utf-8
ratelimit-limit: 2
ratelimit-remaining: 1
ratelimit-reset: 1
ratelimit-daily-limit: 5000
ratelimit-daily-remaining: 4812
ratelimit-daily-reset: 52113

Quando raggiungi un limite

Un invio oltre il limite restituisce 429 Too Many Requests con un header retry-after. Il corpo indica quale limite hai raggiunto:

JSON
{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Maximum 2 messages per second allowed.",
  "limit": 2,
  "current": 2,
  "retry_after": 1
}
Campo Descrizione
error Rate limit exceeded per il limite al secondo, Daily limit exceeded per il limite giornaliero.
limit Il limite raggiunto.
current Quante email erano già state conteggiate nella finestra.
retry_after I secondi da attendere. 1 per il limite al secondo, e i secondi mancanti alle 00:00 UTC per il limite giornaliero.

Quando una richiesta viene rifiutata non viene inviato nulla e non vengono consumati crediti. Se il rifiuto riguarda il limite al secondo, ritenta dopo una breve attesa. Se riguarda il limite giornaliero, metti l’email in coda e inviala dopo l’azzeramento, oppure chiedi un limite più alto.

Altri limiti

Alcuni endpoint hanno limiti propri:

Endpoint Limite Conteggiato per
POST /emails/{id}/forward 3 all’ora Workspace
POST /webhooks/{id}/test 5 al minuto Indirizzo IP
Link ospitati di iscrizione e disiscrizione (/subscribe/{token}, /unsubscribe/{token}) 30 al minuto Indirizzo IP
Endpoint pubblici dei moduli: caricamento di un modulo (GET /forms/{token}) 60 al minuto Indirizzo IP
Endpoint pubblici dei moduli: invio di una risposta (POST /forms/{token}/submit) 30 al minuto Indirizzo IP
Eventi dello script di tracciamento (https://api.emailit.com/public/v1/track/{key}) 600 richieste al minuto, fino a 50 eventi ciascuna Chiave di tracciamento e indirizzo IP

Gli inoltri rientrano anche nei limiti di invio indicati sopra. Oltre il limite di inoltri, l’API restituisce 429 con un header retry-after:

JSON
{
  "error": "too_many_requests",
  "message": "Forwarding is limited to 3 emails per hour for this workspace. Try again later."
}

Questi limiti sono fissi e non cambiano con il piano o con i limiti di invio.

Tutti gli altri endpoint

Gli endpoint che leggono dati o gestiscono risorse non hanno un limite fisso per endpoint. Mantieni un utilizzo ragionevole: usa un piccolo pool di richieste concorrenti invece di migliaia in parallelo, metti in cache i dati che cambiano di rado e usa i webhook invece del polling per lo stato delle email.

Aumenta i limiti

  • Pay as you go. Il primo acquisto di crediti o una licenza AppSumo porta subito il limite da 100 email al giorno a 5000.
  • Pro e Business. Il limite giornaliero aumenta automaticamente e gradualmente man mano che invii, finché i tassi di bounce e di segnalazioni restano bassi. Vedi Aumenti automatici.
  • Richiedine uno. Nella pagina Dashboard, seleziona Request increase nel riquadro Sending Limits, scegli quante email in più ti servono (+5000, +10.000 o +15.000 al giorno, o di più) e indica un limite al secondo (facoltativo), cosa invii e da dove provengono i destinatari. Puoi inviare una richiesta ogni 7 giorni, e di solito il team risponde entro 24 ore.

Per tutti i limiti dei piani, vedi Limiti e quote.

Ritenta con backoff

Ritenta le risposte 429, 409 (chiave di idempotenza ancora in elaborazione), 500 e 503. Quando l’header retry-after è presente, attendi il numero di secondi indicato; quando manca, usa il backoff esponenziale con jitter. Invia un Idempotency-Key perché un invio ritentato non venga mai consegnato due volte, e non aspettare la fine di un limite giornaliero in un ciclo di richieste.

Terminal
# curl retries 429 and 5xx responses and honors retry-after.
curl https://api.emailit.com/v2/emails \
  --retry 5 --retry-max-time 60 \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1042-confirmation" \
  -d '{
    "from": "Acme <orders@acme.com>",
    "to": "ada@example.com",
    "subject": "Your order #1042",
    "text": "Thanks for your order."
  }'

Consigli per grandi volumi

  • Invia da una coda con un numero fisso di worker, e dimensiona il pool in base al limite al secondo.
  • Distribuisci nell’arco della giornata i grandi job in batch invece di avviarli tutti insieme, così un singolo job non consuma tutta la quota giornaliera.
  • Tieni d’occhio ratelimit-daily-remaining e rallenta prima che arrivi a zero.
  • Per le newsletter alle tue liste, usa le campagne invece di chiamare in ciclo l’endpoint di invio.
Limiti di invio e quote dei piani in un unico posto.
Il punteggio che determina gli aumenti automatici dei limiti.
Ritenta gli invii senza inviare due volte.
Tutti i formati di errore e i codici di stato.

Questa pagina ti è stata utile?

Grazie del feedback.

Grazie, leggiamo ogni messaggio.