حدود معدل RTC
APIيحدد RTC عدد الطلبات التي يقبلها في نافذة زمنية معينة. تعمل هذه الحدود على حماية غرف كل عميل من عميل واحد خارج عن السيطرة؛ وهي ليست مقياسًا للفوترة.
ما هو محدود
Section titled “ما هو محدود”| الحد | الأعداد | الغرض |
|---|---|---|
| لكل عنوان IP | كل طلب من عنوان واحد، سواء كان مسجلاً أم لا | الحماية من إساءة الاستخدام؛ الطبقة الأدنى |
| لكل API مفتاح | الطلبات التي تتم باستخدام APIمفتاح مشروع واحد | يمنع تكاملًا واحدًا أو مفتاحًا مسربًا من إعاقة الأداء لدى الآخرين |
| لكل مؤسسة | طلبات جميع المفاتيح وجلسات وحدة التحكم الخاصة بمنظمة RTC واحدة | التوزيع العادل بين العملاء |
يجب أن يستوفي الطلب كل حد ينطبق عليه. تعتمد الحدود لكل مفتاح و لكل مؤسسة على خطتك، ويمكنكCHAMPREP تعديلها للمؤسسة. اقرأ الرؤوس أدناه بدلاً من الترميز الثابت للأرقام.
بعض العمليات لها حدودها الخاصة الأضيق التي تُستجاب برمز محدد، على سبيل المثال إعادة تشغيل webhook (REPLAY_QUOTA) ورسائل التطبيق داخل الغرفة (MESSAGE_RATE_LIMITED).
رؤوس الرسائل
Section titled “رؤوس الرسائل”تحمل الاستجابات المصادق عليها حالة الحد الأضيق المطبق:
| رأس الرسالة | المعنى |
|---|---|
X-RateLimit-Limit | الطلبات المسموح بها في النافذة الحالية |
X-RateLimit-Remaining | الطلبات المتبقية في النافذة الحالية |
X-RateLimit-Reset | ثوانٍ حتى إعادة تعيين النافذة |
الطلب الذي يتجاوز الحد الأقصى يُجاب عليه 429 مع الكود
RATE_LIMITED و Retry-After رأس الرسالة، في ثوانٍ.
HTTP/1.1 429 Too Many RequestsRetry-After: 12X-RateLimit-Limit: 600X-RateLimit-Remaining: 0X-RateLimit-Reset: 12X-Error-Code: RATE_LIMITEDX-Request-Id: 6f1c2b8e-1d2a-4c55-9a8e-0f4b9b1d7c21الأرقام المذكورة أعلاه هي أمثلة توضيحية.
تراجع بشكل صحيح
Section titled “تراجع بشكل صحيح”- في
429، انتظر ما لا يقل عنRetry-Afterثوانٍ قبل الطلب التالي، ثم استأنف العمل تدريجيًا. لا تقم بإعادة المحاولة في حلقة مفرغة. - وزع الأعمال الدورية (الاستقصاء، والتسوية) على مدار الوقت، وافضل webhooks على الاستقصاء.
- استخدم APIمفتاحًا واحدًا لكل تكامل: فحد هذا المفتاح الخاص به يحتوي على مهمة خارجة عن السيطرة، ويمكنك إلغاء مفتاح واحد دون التأثير على المفاتيح الأخرى.
- قم بإنشاء بيانات اعتماد المشاركين عندما ينضم المستخدم فعليًّا، وليس مسبقًا. في حالة ارتفاع أعداد الانضمام، إنشاء رموز الانضمام دون اتصال بالإنترنت باستخدام مفتاح توقيع المشروع.
- استخدم
?limitو?cursorلتصفح القوائم بدلاً من تكرار طلبات القوائم الكاملة.