الحدود العامة

يحدّ 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.