Globala gränser

Brevo begränsar API-förfrågningar per endpoint. Varje gräns är ett antal förfrågningar per sekund (RPS), per timme (RPH) eller båda. Siffrorna nedan kommer från Brevos sida om rate limits, kontrollerad den 7 oktober 2026. Kontrollera den sidan innan du dimensionerar ett stort jobb.

Nivåer för rate limits

Gränser per nivå

När en endpoint har både en RPS- och en RPH-gräns ska du hålla dig under båda.

Headers för rate limits

Endpoints med rate limit returnerar dessa headers:

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

Beskrivning av headers

• x-sib-ratelimit-limit: tillåtna förfrågningar i det aktuella fönstret
• x-sib-ratelimit-remaining: återstående förfrågningar i det aktuella fönstret
• x-sib-ratelimit-reset: tid tills fönstret återställs, vanligtvis i sekunder

Brevo dokumenterar dessa headers på sin sida om rate limit-headers.

Övervaka användning

Kontrollera aktuell användning

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

Hantera rate limits

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

När du fortsätter nå gränserna

1. Sprid förfrågningarna jämnt: en gräns på 1 000 RPS tillåter upp till 60 000 förfrågningar per minut bara när de sprids jämnt.
2. Batcha och cacha: använd bulk-endpoints och undvik att läsa om data som du redan har.
3. Använd webhooks för statistik: ta emot händelser i stället för att polla statistik-endpoints.
4. Överväg en högre nivå: den avancerade och den utökade nivån ingår i Professional- och Enterprise-abonnemang.