الشبكة وحدود المعدل

تنطبق قاعدتان شبكيتان على كل مفتاح إنتاج: يجب أن تأتي الطلبات من عناوين IP التي سجلتها لدى أوكتين، ولا يجوز للمفتاح أن يرسل أكثر من 60 طلبًا في الدقيقة. تُفرض القاعدتان قبل وصول الطلب إلى الواجهة، فيحصل الطلب المحظور على خطأ JSON قصير لا غير.

قائمة IP المسموح بهاCopy Anchor Link

كل مفتاح إنتاج مقيّد بقائمة عناوين IP أو نطاقات CIDR تقدمها أنت. تُرفض الطلبات من أي عنوان مصدر آخر:

HTTP/1.1 403 Forbidden
{ "error": { "code": "IP_NOT_ALLOWED" } }

• قدّم عناوين IP العامة الصادرة للأنظمة التي تستدعي الواجهة. إذا كنت خلف بوابة NAT أو مزود سحابي، فهذا عنوان البوابة لا العنوان الداخلي.
• تُقبل العناوين الفردية ونطاقات CIDR.
• تمر تغييرات القائمة عبر أوكتين. أرسل العناوين الجديدة إلى مدير حسابك قبل أي تغيير في بنيتك التحتية؛ يُطبَّق التحديث من جانب أوكتين وليس فوريًا.
• تنطبق القائمة على واجهة السحب فقط. الويب هوك صادر من أوكتين ولا يتأثر.
• مفاتيح الاختبار غير مقيّدة بعنوان IP.

حد المعدلCopy Anchor Link

يجوز لكل مفتاح إرسال 60 طلبًا لكل نافذة 60 ثانية. يُرفض الطلب رقم 61 في النافذة حتى تُعاد النافذة:

HTTP/1.1 429 Too Many Requests
Retry-After: 60
Content-Type: application/json

{ "error": { "code": "RATE_LIMITED" } }

• الحد لكل مفتاح. لا تعتمد على توزيع الطلبات على عدة عناوين IP للحصول على سعة أكبر.
• لا توجد حصة يومية منفصلة.
• يمكن لأوكتين ضبط حد مختلف لمفتاح عند الطلب إذا كان لتكاملك حاجة مبررة.

ماذا أفعل عند 429؟Copy Anchor Link

احترم ترويسة Retry-After (بالثواني) وانتظر على الأقل تلك المدة قبل إعادة المحاولة. نمط بسيط:

async function octaneFetch(url, options, attempt = 0) {
  const res = await fetch(url, options);
  if (res.status === 429 && attempt < 5) {
    const retryAfter = Number(res.headers.get('Retry-After') ?? 60);
    await new Promise((r) => setTimeout(r, retryAfter * 1000));
    return octaneFetch(url, options, attempt + 1);
  }
  return res;
}

كيف أبقى تحت الحد؟Copy Anchor Link

• استخدم limit=100 عند جلب السجل لتقليل عدد الطلبات.
• زامن وفق جدول بدلًا من الاستطلاع المستمر. مزامنة كل 15 دقيقة لآخر ساعة نمط شائع.
• فضّل الويب هوك للاحتياجات شبه الفورية واستخدم واجهة السحب للتسوية.
• شغّل عملية مزامنة واحدة لكل مفتاح؛ العمال المتوازون الذين يتشاركون مفتاحًا يستنفدون الحد بسرعة.