Limites globales

Brevo limite les requêtes d’API par endpoint. Chaque limite est un nombre de requêtes par seconde (RPS), par heure (RPH), ou les deux. Les chiffres ci-dessous proviennent de la page des limites de débit de Brevo, consultée le 7 octobre 2026. Consultez cette page avant de dimensionner une tâche volumineuse.

Paliers de limite de débit

Limites par palier

Lorsqu’un endpoint a à la fois une limite RPS et une limite RPH, restez sous les deux.

En-têtes de limite de débit

Les endpoints soumis à une limite de débit renvoient ces en-têtes :

HTTP/1.1 200 OK
x-sib-ratelimit-limit: 1000
x-sib-ratelimit-remaining: 750
x-sib-ratelimit-reset: 1

Description des en-têtes

• x-sib-ratelimit-limit: requêtes autorisées dans la fenêtre en cours
• x-sib-ratelimit-remaining: requêtes restantes dans la fenêtre en cours
• x-sib-ratelimit-reset: temps restant avant la réinitialisation de la fenêtre, généralement en secondes

Brevo documente ces en-têtes sur sa page des en-têtes de limite.

Surveiller l’utilisation

Vérifier l’utilisation actuelle

const checkRateLimit = async () => {
  const response = await fetch('https://api.brevo.com/v3/account', {
    headers: { 'api-key': process.env.BREVO_API_KEY }
  });

  console.log({
    limit: response.headers.get('x-sib-ratelimit-limit'),
    remaining: response.headers.get('x-sib-ratelimit-remaining'),
    resetInSeconds: Number(response.headers.get('x-sib-ratelimit-reset'))
  });
};

Gérer les limites de débit

Backoff exponentiel

const makeRequestWithBackoff = async (url, options, maxRetries = 3) => {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url, options);

    if (response.status !== 429) return response;

    const resetSeconds = Number(response.headers.get('x-sib-ratelimit-reset') || 1);
    const delay = Math.max(resetSeconds * 1000, 1000 * Math.pow(2, i));

    console.log(`Rate limited. Waiting ${delay}ms before retry ${i + 1}`);
    await new Promise(resolve => setTimeout(resolve, delay));
  }
  throw new Error('Rate limit retries exhausted');
};

Si vous atteignez sans cesse les limites

1. Répartissez les requêtes uniformément: une limite de 1 000 RPS n’autorise jusqu’à 60 000 requêtes par minute que si elles sont réparties uniformément.
2. Regroupez et mettez en cache: utilisez les endpoints en masse et évitez de relire des données que vous avez déjà.
3. Utilisez les webhooks pour les statistiques: recevez les événements au lieu d’interroger en boucle les endpoints de statistiques.
4. Envisagez un palier supérieur: les paliers avancé et étendu sont inclus avec les forfaits Professional et Enterprise.