Limity globalne

Brevo ogranicza zapytania API per endpoint. Każdy limit to liczba zapytań na sekundę (RPS), na godzinę (RPH) lub oba naraz. Poniższe wartości pochodzą ze strony o rate limits Brevo, sprawdzonej 7 października 2026. Zajrzyj na tę stronę, zanim zaplanujesz duże zadanie.

Poziomy rate limits

Limity według poziomu

Gdy endpoint ma zarówno limit RPS, jak i RPH, mieść się w obu.

Nagłówki rate limits

Endpointy objęte rate limit zwracają te nagłówki:

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

Opis nagłówków

• x-sib-ratelimit-limit: dozwolone zapytania w bieżącym oknie
• x-sib-ratelimit-remaining: pozostałe zapytania w bieżącym oknie
• x-sib-ratelimit-reset: czas do zresetowania okna, zwykle w sekundach

Brevo opisuje te nagłówki na swojej stronie o nagłówkach rate limit.

Monitorowanie użycia

Sprawdzanie bieżącego użycia

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

Obsługa rate limits

Wykładniczy backoff

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

Gdy stale trafiasz w limity

1. Rozkładaj zapytania równomiernie: limit 1 000 RPS pozwala na do 60 000 zapytań na minutę tylko wtedy, gdy są rozłożone równomiernie.
2. Grupuj i cache’uj: używaj endpointów zbiorczych i unikaj ponownego odczytu danych, które już masz.
3. Używaj webhooków do statystyk: odbieraj zdarzenia zamiast odpytywać endpointy statystyk.
4. Rozważ wyższy poziom: poziom zaawansowany i rozszerzony są dostępne w planach Professional i Enterprise.