Genel Sınırlar

Brevo, API isteklerini uç nokta başına sınırlar. Her sınır, saniyedeki istek sayısı (RPS), saatteki istek sayısı (RPH) veya her ikisidir. Aşağıdaki rakamlar Brevo’nun hız limitleri sayfasından alınmıştır ve 7 Ekim 2026’da kontrol edilmiştir. Büyük bir işi boyutlandırmadan önce o sayfayı kontrol edin.

Hız sınırı kademeleri

Kademelere göre sınırlar

Bir uç noktanın hem RPS hem RPH sınırı varsa ikisinin de altında kalın.

Hız sınırı başlıkları

Hız limitli uç noktalar şu başlıkları döndürür:

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

Başlık açıklamaları

• x-sib-ratelimit-limit: geçerli pencerede izin verilen istek sayısı
• x-sib-ratelimit-remaining: geçerli pencerede kalan istek sayısı
• x-sib-ratelimit-reset: pencerenin sıfırlanmasına kalan süre, genellikle saniye cinsinden

Brevo bu başlıkları hız limiti başlıkları sayfasında belgelemiştir.

Kullanımı izleme

Geçerli kullanımı kontrol etme

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

Hız sınırlarını yönetme

Üstel geri çekilme

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

Sınırlara Takılmaya Devam Ederseniz

1. İstekleri eşit yayın: saniyede 1.000 istek sınırı, dakikada 60.000 isteğe yalnızca istekler eşit yayıldığında izin verir.
2. Toplu işleyin ve önbelleğe alın: toplu uç noktaları kullanın ve zaten elinizde olan verileri yeniden okumaktan kaçının.
3. İstatistikler için webhook kullanın: istatistik uç noktalarını sürekli sorgulamak yerine olayları alın.
4. Daha yüksek bir kademeyi değerlendirin: gelişmiş ve genişletilmiş kademeler Professional ve Enterprise planlarıyla gelir.