Глобальные лимиты

Brevo ограничивает запросы к API для каждого эндпоинта. Каждый лимит задан числом запросов в секунду (RPS), в час (RPH) или обоими значениями. Приведённые ниже значения взяты со страницы лимитов Brevo, проверено 7 октября 2026 года. Проверьте эту страницу, прежде чем рассчитывать крупную задачу.

Уровни лимитов частоты запросов

Лимиты по уровням

Если у эндпоинта есть и лимит RPS, и лимит RPH, укладывайтесь в оба.

Заголовки лимитов частоты запросов

Эндпоинты с ограничением частоты возвращают такие заголовки:

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

Описание заголовков

• x-sib-ratelimit-limit: число запросов, разрешённых в текущем окне
• x-sib-ratelimit-remaining: число запросов, оставшихся в текущем окне
• x-sib-ratelimit-reset: время до сброса окна, обычно в секундах

Brevo описывает эти заголовки на странице о заголовках лимитов.

Мониторинг использования

Проверка текущего использования

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'))
  });
};

Обработка лимитов частоты запросов

Экспоненциальная задержка

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');
};

Если вы постоянно упираетесь в лимиты

1. Распределяйте запросы равномерно: лимит 1 000 RPS допускает до 60 000 запросов в минуту только при равномерном распределении.
2. Группируйте и кэшируйте: используйте массовые эндпоинты и не перечитывайте данные, которые у вас уже есть.
3. Используйте вебхуки для статистики: получайте события вместо того, чтобы опрашивать эндпоинты статистики.
4. Рассмотрите более высокий уровень: расширенный и максимальный уровни входят в тарифы Professional и Enterprise.