حدود معدل طلبات WEEX API: أوزان الطلبات وأخطاء 429
حدود معدل طلبات WEEX API: أوزان الطلبات وأخطاء 429
تعتمد حدود WEEX API على نوع الطلب. تستخدم واجهات REST API أوزان الطلبات المستندة إلى عنوان IP وحصص الأوامر المستندة إلى الحساب، بينما تخضع اتصالات WebSocket والاشتراكات لحدود خاصة بها. لمعرفة الحصة المطبقة على تكاملك، راجع exchangeInfo الخاص بالمنتج، ووزن نقطة النهاية، وترويسات الاستجابة. إذا تلقيت HTTP 429، فأوقف الطلبات المتأثرة مؤقتًا قبل تعديل وتيرتها.
قد يصل الروبوت إلى الحد حتى عندما يبدو حجم حركة البيانات الخاصة به متواضعًا. فقد تتشارك خدمات بيانات السوق ونصوص المراقبة والاستراتيجيات الأخرى عنوان IP الصادر نفسه. وفهم هذه الحصة المشتركة أكثر فائدة من تعيين حد منفصل للطلبات في الثانية لكل عملية.
ما الفرق بين أعداد الطلبات وأوزانها وحدود الأوامر؟
توضح قيود الوصول للسوق الفوري وقيود الوصول للعقود الآجلة ميزانيتين لطلبات REST:
| نوع الطلب | على ماذا تستند الحصة؟ | الأثر العملي |
|---|---|---|
| بيانات السوق، واستعلامات الحساب، ونقاط النهاية الأخرى غير الخاصة بإرسال الأوامر | وزن الطلبات لعنوان IP الصادر | تحتاج التطبيقات التي تتشارك عنوان IP إلى تنسيق حركة بياناتها. |
| إرسال الأوامر | حصة ORDERS الخاصة بـ userId للحساب | تستهلك الطلبات الحصة الموثقة للأوامر. ولا تستهلك طلبات الإرسال هذه وزن IP. |
الوزن لا يقتصر على عدد مرات استدعاء واجهة برمجة التطبيقات. فالاستعلام ذو الوزن 10 يستهلك 10 وحدات وزن، كما أن وزن بعض نقاط النهاية يتغير وفقًا لمعاملات الطلب. لذلك، قد تستهلك عشرون عملية استدعاء كميات مختلفة بحسب نقاط النهاية المستخدمة.
يستخدم إرسال الأوامر الفردية والمجمعة في السوق الفوري حصة الأوامر. أما الإلغاءات واستعلامات الأوامر فتظل خاضعة لحدود IP. ولا يمنح تبديل مفاتيح API التطبيق نفسه ميزانية IP جديدة.
أين يمكنني التحقق من الحصة الحالية؟
للسوق الفوري والعقود الآجلة نقطتا نهاية منفصلتان لمعلومات المنصة:
| المنتج | عنوان الاستعلام |
|---|---|
| السوق الفوري | GET https://api-spot.weex.com/api/v3/exchangeInfo |
| العقود الآجلة | GET https://api-contract.weex.com/capi/v3/market/exchangeInfo |
ابحث عن rateLimits في الاستجابة واقرأ حقولها الأربعة معًا. يحدد rateLimitType نوع الميزانية، ويحدد interval وintervalNum النافذة الزمنية، بينما يبيّن limit الحصة المتاحة ضمن تلك النافذة.
على سبيل المثال، أعادت استجابة السوق الفوري التي جرى التحقق منها في 4 نوفمبر 2026 قيمة REQUEST_WEIGHT تبلغ 500 لكل 10 ثوانٍ، وقيمة ORDERS تبلغ 100 لكل 10 ثوانٍ. يمثل الرقم الأول وحدات الوزن، أما الثاني فيمثل حصة الأوامر. تصف هذه القيم إعداد السوق الفوري في تلك اللقطة. ينبغي عدم نسخها إلى العقود الآجلة أو التعامل معها كثوابت دائمة في تطبيقك.
استعلم عن نقطة نهاية العقود الآجلة لمعرفة حدود العقود الآجلة. إذا اختلفت استجابتها عن الأسئلة الشائعة أو مرجع نقطة النهاية، فاحتفظ بالاستجابة ووقت الاستعلام حتى يتمكن دعم API من تأكيد القاعدة قبل تغيير حركة بيانات بيئة الإنتاج.
استخدم ترويسات الاستجابة لتتبّع الاستخدام أثناء تشغيل التطبيق
تعرض استجابات IP الترويستين X-USED-WEIGHT-(intervalNum)(intervalLetter) وX-REMAINING-WEIGHT-(intervalNum)(intervalLetter) للوزن المستخدم والمتبقي. على سبيل المثال، تشير X-USED-WEIGHT-1M إلى الوزن الذي استخدمه عنوان IP الحالي خلال نافذة مدتها دقيقة واحدة.
يستخدم إرسال الأوامر X-ORDER-COUNT-(intervalNum)(intervalLetter) وX-ORDER-REMAINING-(intervalNum)(intervalLetter). سجّل أسماء الفترات التي تظهر فعليًا في الاستجابة لتتمكن من معرفة الحد الذي يقترب التطبيق من بلوغه.
عندما تتشارك عدة خدمات عنوان IP أو حسابًا، فكّر في إدارة حصصها مركزيًا. إن ترك سعة لاستعلامات الأوامر وإلغائها والاسترداد يتيح لهذه العمليات مجالًا للعمل عند زيادة حركة بيانات السوق.
كيف أتعافى من HTTP 429؟
أوقف مؤقتًا قائمة انتظار الطلبات التي بلغت الحد، وافحص ترويسات الاستجابة والنافذة الزمنية. ثم زد فترات التأخير بين المحاولات تدريجيًا، مع إضافة تفاوت عشوائي حتى لا تستأنف العمليات معًا وتصطدم بالحد نفسه فورًا. اختر فترات التأخير بما يتناسب مع النافذة المعنية بدلًا من الاعتماد على قيمة ثابتة واحدة لكل طلب.
بعد ذلك، تتبّع حركة البيانات. ابحث عن الاستعلام المتكرر غير الضروري، أو طلبات البيانات الكاملة التي لا حاجة إليها، أو الروبوتات التي تتشارك عنوان IP بينما تتعقب حصصها كلٌّ على حدة. فقد يؤدي إبطاء عملية واحدة إلى عدم تغيير حركة البيانات الإجمالية.
تنص قيود الوصول الرسمية على أن تجاوز الحد يؤدي إلى استجابة 429، وأن تكرار المخالفات ينتج عنه حظر لمدة 10 ثوانٍ. ولا تضمن مدة الحظر التعافي بعد الانتظار 10 ثوانٍ بالضبط. إذا انتهت مهلة طلب أمر أيضًا أو كانت نتيجته غير واضحة، فتحقق من حالته قبل إرساله مجددًا لتجنب تكراره.
ما حدود WebSocket المنفصلة؟
تحدد وثائق WebSocket الخاصة بـالسوق الفوري والعقود الآجلة حدًا أقصاه 300 طلب اتصال لكل عنوان IP خلال خمس دقائق، و20 اتصالًا متزامنًا لكل عنوان IP، و240 عملية اشتراك لكل اتصال في الساعة، وما يصل إلى 100 قناة لكل اتصال.
تقيس هذه الحدود نشاط الاتصال أو الاشتراك. ولا تعني أن الخادم لا يستطيع إرسال أكثر من 240 تحديثًا للسوق أو الأوامر في الساعة. يقلل إعادة استخدام الاتصالات، والحفاظ على سجل للاشتراكات، والتعامل مع رسائل نبض الاتصال من محاولات الاتصال والاشتراكات غير الضرورية. طبّق أيضًا فترات انتظار متزايدة عند إعادة الاتصال بعد حدوث عطل.
تظل هذه الحدود مهمة عند استخدام CCXT أو حزمة تطوير برمجية، خصوصًا عبر التطبيقات التي تتشارك عنوان IP أو حسابًا. إذا اختلفت الحدود المرصودة عما تتوقعه، فاستخدم روابط الدعم في الأسئلة الشائعة الرسمية حول API. أرفق نقطة النهاية والطابع الزمني ورمز الحالة وترويسات الاستجابة بعد تنقيحها للمساعدة في تشخيص المشكلة.