Quotas et limites
Ce que chaque forfait autorise, et comment les limites sont appliquées.
Comparatif des forfaits
| Forfait | Emails / mois | Clés API | Comptes SMTP | Destinataires / email | Templates | Pièces jointes |
|---|---|---|---|---|---|---|
| Gratuit | 100 | 1 | 0 (compte système) | 5 | — | — |
| Basic | 2 000 | 3 | 1 | 20 | — | — |
| Pro | 20 000 | 10 | 5 | 50 | 50 | 5 · 10 Mo |
| Team | 60 000 | 25 | 10 | 100 | — | — |
| Agency | 200 000 | 100 | 30 | 200 | 500 | 10 · 20 Mo |
| Enterprise | illimité | 500 | 100 | 500 | 2 000 | 20 · 25 Mo |
Les valeurs applicables à votre compte sont affichées sur votre tableau de bord ; les tarifs sont sur la page Facturation.
Forfait requis
Quota mensuel
- Le compteur porte sur le mois civil, en UTC, et repart à zéro le 1er à 00:00.
- Un appel API = un email, quel que soit le nombre de destinataires : écrire à 20 personnes en une requête consomme 1 unité.
- Une requête refusée pour cause de validation ne consomme rien.
- Un envoi tenté mais rejeté par le serveur SMTP (erreur 502) est décompté.
Chaque réponse rappelle votre consommation :
"quota": { "used": 128, "quota": 20000 }
"quota": 0 signifie « illimité » (forfait Enterprise).
Limites de débit (rate limiting)
Quatre fenêtres sont contrôlées simultanément — par minute, par heure, par jour et par mois — selon un algorithme de « seau à jetons » (token bucket) : les jetons se reconstituent progressivement, ce qui autorise de courtes rafales tout en tenant la moyenne.
Ces limites s'appliquent par clé API. Répartir vos envois sur plusieurs clés augmente donc le débit total possible, sans changer le quota mensuel, qui reste global au compte.
| Forfait | Par minute | Par heure | Par jour |
|---|---|---|---|
| Gratuit | 5 | 30 | 100 |
| Basic | 20 | 300 | 2 000 |
| Pro | 60 | 1 500 | 20 000 |
| Team | 120 | 4 000 | 60 000 |
| Agency | 300 | 12 000 | 200 000 |
| Enterprise | sans limite de débit | ||
Quand une fenêtre est saturée, l'API répond 429 en indiquant le délai d'attente :
{
"success": false,
"error": { "code": "rate_limited", "message": "Limite de débit dépassée (fenêtre : minute)." },
"retry_after": 27
}
Envoyer un volume important
- Étalez les envois : une file d'attente qui consomme à débit constant vaut mieux qu'une rafale suivie de 429 en série.
- Respectez
retry_afterplutôt que de réessayer immédiatement. - Dédiez une clé API par usage (transactionnel, notifications, exports) : un incident sur l'un n'épuise pas le débit des autres.
- Surveillez votre consommation sur le tableau de bord avant les périodes de forte activité.
Restreindre les adresses IP
À partir du forfait Pro, vous pouvez limiter l'usage d'une clé API à certaines adresses IP ou plages CIDR, depuis IP autorisées. Une clé dérobée devient alors inutilisable depuis l'extérieur de votre infrastructure.
- Une règle sans clé associée s'applique à toutes les clés du compte.
- Sans aucune règle applicable, aucune restriction n'est appliquée.
- Chaque blocage est journalisé et peut déclencher une alerte par email.
Changer de forfait
Depuis Facturation. Une montée en gamme prend effet immédiatement, avec remboursement au prorata de l'ancien forfait ; une baisse de gamme est programmée à la fin de la période en cours, de sorte que vous conservez vos limites jusque-là.