تخطَّ إلى المحتوى
Documentation

حدود معدل RTC

APIيحدد RTC عدد الطلبات التي يقبلها في نافذة زمنية معينة. تعمل هذه الحدود على حماية غرف كل عميل من عميل واحد خارج عن السيطرة؛ وهي ليست مقياسًا للفوترة.

الحدالأعدادالغرض
لكل عنوان IPكل طلب من عنوان واحد، سواء كان مسجلاً أم لاالحماية من إساءة الاستخدام؛ الطبقة الأدنى
لكل API مفتاحالطلبات التي تتم باستخدام APIمفتاح مشروع واحديمنع تكاملًا واحدًا أو مفتاحًا مسربًا من إعاقة الأداء لدى الآخرين
لكل مؤسسةطلبات جميع المفاتيح وجلسات وحدة التحكم الخاصة بمنظمة RTC واحدةالتوزيع العادل بين العملاء

يجب أن يستوفي الطلب كل حد ينطبق عليه. تعتمد الحدود لكل مفتاح و لكل مؤسسة على خطتك، ويمكنكCHAMPREP تعديلها للمؤسسة. اقرأ الرؤوس أدناه بدلاً من الترميز الثابت للأرقام.

بعض العمليات لها حدودها الخاصة الأضيق التي تُستجاب برمز محدد، على سبيل المثال إعادة تشغيل webhook (REPLAY_QUOTA) ورسائل التطبيق داخل الغرفة (MESSAGE_RATE_LIMITED).

تحمل الاستجابات المصادق عليها حالة الحد الأضيق المطبق:

رأس الرسالةالمعنى
X-RateLimit-Limitالطلبات المسموح بها في النافذة الحالية
X-RateLimit-Remainingالطلبات المتبقية في النافذة الحالية
X-RateLimit-Resetثوانٍ حتى إعادة تعيين النافذة

الطلب الذي يتجاوز الحد الأقصى يُجاب عليه 429 مع الكود RATE_LIMITED و Retry-After رأس الرسالة، في ثوانٍ.

HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 600
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12
X-Error-Code: RATE_LIMITED
X-Request-Id: 6f1c2b8e-1d2a-4c55-9a8e-0f4b9b1d7c21

الأرقام المذكورة أعلاه هي أمثلة توضيحية.

  • في 429، انتظر ما لا يقل عن Retry-After ثوانٍ قبل الطلب التالي، ثم استأنف العمل تدريجيًا. لا تقم بإعادة المحاولة في حلقة مفرغة.
  • وزع الأعمال الدورية (الاستقصاء، والتسوية) على مدار الوقت، وافضل webhooks على الاستقصاء.
  • استخدم APIمفتاحًا واحدًا لكل تكامل: فحد هذا المفتاح الخاص به يحتوي على مهمة خارجة عن السيطرة، ويمكنك إلغاء مفتاح واحد دون التأثير على المفاتيح الأخرى.
  • قم بإنشاء بيانات اعتماد المشاركين عندما ينضم المستخدم فعليًّا، وليس مسبقًا. في حالة ارتفاع أعداد الانضمام، إنشاء رموز الانضمام دون اتصال بالإنترنت باستخدام مفتاح توقيع المشروع.
  • استخدم ?limit و ?cursor لتصفح القوائم بدلاً من تكرار طلبات القوائم الكاملة.