Глобални ограничения

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. Използвайте webhooks за статистика: получавайте събития, вместо да питате периодично крайните точки за статистика.
4. Обмислете по-високо ниво: разширеното и максималното ниво идват с плановете Professional и Enterprise.