Limites de débit

Les limites protègent la plateforme et votre réputation d'expéditeur. Vos propres limites dépendent de votre offre et figurent dans votre tableau de bord.

Pourquoi des limites existent

Les fournisseurs de messagerie jugent un expéditeur sur son historique. Un pic soudain de volume ressemble à un abus ; les limites et la montée en charge progressive protègent donc votre réputation de domaine et d'IP autant que la plateforme. Des limites plus élevées sont disponibles sur demande.

Trouver vos limites

Les limites de votre compte dépendent de votre offre et de l'ancienneté de vos envois. Consultez le tableau de bord pour les valeurs actuelles, ou contactez le support si vous avez besoin de plus de marge pour un lancement ou un pic saisonnier.

Lire les en-têtes

Les réponses peuvent indiquer votre quota restant. Si vous recevez un 429, attendez la durée indiquée dans Retry-After avant de réessayer.

X-RateLimit-Limit: <requests allowed>
X-RateLimit-Remaining: <requests left>
Retry-After: <seconds to wait>

Réessayer avec backoff

Attendez plus longtemps après chaque échec et ajoutez un peu d'aléatoire, pour que de nombreux clients ne réessaient pas au même instant. Plafonnez le nombre de tentatives.

async function send(payload, tries = 5) {
  for (let i = 0; i < tries; i++) {
    const res = await post(payload);
    if (res.status !== 429 && res.status < 500) return res;
    const wait = Number(res.headers.get("retry-after")) * 1000 || 2 ** i * 500;
    await new Promise((r) => setTimeout(r, wait + Math.random() * 250));
  }
  throw new Error("gave up after retries");
}

Anticiper les pics

Si vous prévoyez un gros envoi, comme des soldes ou une rentrée, prévenez-nous à l'avance, étalez l'envoi dans le temps et faites monter en charge progressivement tout nouveau domaine ou IP dédiée. Les pics soudains sont la cause la plus fréquente de limitation par les fournisseurs de messagerie.