إعادة اتصال WEEX WebSocket: استعادة تحديثات الطلبات
إعادة اتصال WEEX WebSocket: استعادة تحديثات الطلبات
بعد انقطاع اتصال WEEX WebSocket، أعد الاتصال الخاص باستخدام طابع زمني وتوقيع جديدين، وأعِد الاشتراك في orders، ثم تأكد من نجاح الاشتراك. بعد ذلك، استخدم استعلامات REST لمطابقة حالة الطلبات خلال فترة الانقطاع قبل السماح لأي استراتيجية بالاعتماد على تلك البيانات مجدداً.
على سبيل المثال، قد يكون طلب مفتوح قبل الانقطاع قد نُفّذ قبل إعادة الاتصال. تلقي التحديثات الجديدة وحده لا يخبرك بكل ما حدث أثناء الفجوة. ينبغي أن تشمل عملية الاستعادة الاتصال وأي اختلاف بين سجلات الطلبات المحلية والحالة الفعلية للحساب.
احتفظ بالمعلومات التي ستحتاج إليها للاستعادة
راقب حالات إغلاق الاتصال وأخطاء الشبكة وإخفاقات استجابات نبضات القلب. عند حدوث انقطاع، سجّل وقت آخر رسالة تلقيتها بنجاح واحتفظ بمعرّفات الطلبات المعروفة ومعرّفات طلبات العميل والحالة المحلية. ستستخدم هذه التفاصيل للاستعلام عن الطلبات لاحقاً.
عيّن حالة الطلب على أنها بانتظار المطابقة، وأوقف الإجراءات الآلية التي تتطلب رؤية كاملة للعمل بأمان. أعد الاتصال باستخدام تراجع أُسي محدود مع تأخير عشوائي، كي لا تجري العمليات محاولات متزامنة متكررة. تشمل الحدود الموثقة 300 طلب اتصال لكل IP خلال خمس دقائق، وما يصل إلى 20 اتصالاً متزامناً لكل IP، و240 عملية اشتراك لكل اتصال في الساعة. اختر إعدادات التراجع مع مراعاة هذه الحدود.
أعِد المصادقة للاتصال الخاص الصحيح
تُرسل تحديثات الطلبات عبر القناة الخاصة بالمنتج المعني:
| المنتج | عنوان WebSocket الخاص |
|---|---|
| التداول الفوري | wss://ws-spot.weex.com/v3/ws/private |
| العقود الآجلة | wss://ws-contract.weex.com/v3/ws/private |
يتطلب الاتصال الأولي User-Agent وACCESS-KEY وACCESS-PASSPHRASE وACCESS-TIMESTAMP وACCESS-SIGN. استخدم طابعاً زمنياً بالمللي ثانية يطابق القيمة الواردة في التوقيع. تذكر الوثائق أن صلاحيته تنتهي بعد 30 ثانية، لذا أنشئ بيانات مصادقة جديدة لكل اتصال جديد.
رسالة التوقيع الخاصة بـ WebSocket هي:
timestamp + "/v3/ws/private"طبّق HMAC-SHA256 باستخدام SecretKey، ثم حوّل النتيجة إلى Base64 لتعيينها في ACCESS-SIGN. يستخدم ذلك صيغة التوقيع الخاصة بـ WebSocket، وليس طريقة إنشاء طلب REST كاملة. راجع وثائق WebSocket للتداول الفوري ووثائق WebSocket للعقود الآجلة للاطلاع على تفاصيل الاتصال.
أعِد الاشتراك في الطلبات وتحقق من الإقرار
أرسل هذا الطلب عبر الاتصال الخاص الجديد:
{"method":"SUBSCRIBE","params":["orders"],"id":1}توضح مراجع قناة الطلبات للتداول الفوري وقناة الطلبات للعقود الآجلة الإقرار الناجح التالي:
{"result":true,"id":1}طابق الاستجابة مع طلب الاشتراك باستخدام id، وافحص msg في حال فشل الطلب. هذا معرّف للطلب، وليس معرّفاً للصفقة. الاقتصار على تسجيل عبارة «تم الاتصال بـ WebSocket» قد يؤدي إلى تفويت حالة نجاح الاتصال ثم فشل الاشتراك.
يتطلب الاتصال أيضاً التعامل مع نبضات القلب على مستوى تطبيق WEEX. تظهر رسالة ping خاصة بهذا الشكل: {"type":"ping","time":"1693208170000"}؛ أما القنوات العامة فتستخدم event. والاستجابة الموثقة هي:
{"method":"PONG","id":1}لا يغني تعامل المكتبة مع ping وpong على مستوى البروتوكول عن معالجة رسائل JSON هذه. تذكر الوثائق أن الخادم يقطع الاتصال بعد أكثر من 10 رسائل ping بلا استجابة، لكنها لا تحدد فترة موحدة لنبضات القلب يمكن استخدامها لحساب وقت ثابت لانقطاع الاتصال.
طابِق البيانات عبر REST، بما فيها الطلبات التي لم تعد مفتوحة
عند استئناف ورود أحداث الطلبات، خزّنها مؤقتاً أثناء الاستعلام عن الطلبات المفتوحة وسجل الطلبات وتفاصيل الطلبات المعروفة. قارن الحالة وإجمالي عمليات التنفيذ التراكمية وأوقات التحديث. هذه طريقة استعادة على جانب العميل للتعامل مع التغييرات التي ربما فاتتك أثناء الانقطاع؛ فلا تفترض أن الخادم يعيد إرسال جميع الرسائل السابقة.
| المعلومات المطلوب مطابقتها | مسار GET للتداول الفوري | مسار GET للعقود الآجلة |
|---|---|---|
| الطلبات المفتوحة | /api/v3/openOrders | /capi/v3/openOrders |
| سجل الطلبات | /api/v3/allOrders | /capi/v3/order/history |
| تفاصيل طلب فردي | /api/v3/order | /capi/v3/order |
لا يكفي الاستعلام عن الطلبات المفتوحة وحدها، إذ إنه يفوّت حالة مهمة: قد لا يظهر فيها طلب نُفّذ أو أُلغي أثناء الفجوة. لذلك ينبغي إدراج سجل الطلبات وتفاصيل الطلبات المعروفة ضمن عملية الاستعادة.
تعامَل مع النطاقات الزمنية والحقول المطلوبة وتقسيم الصفحات الخاصة بكل نقطة نهاية. فعلى سبيل المثال، يتطلب allOrders للتداول الفوري الحقل symbol، بينما يتيح سجل العقود الآجلة الحقلين page وlimit. اتبع قواعد سجل التداول الفوري وسجل العقود الآجلة لاسترجاع السجلات ذات الصلة قبل دمج الأحداث المخزنة مؤقتاً.
يجب ألا تؤدي الأحداث المكررة إلى تكرار إجراءات المحاسبة أو إجراءات العمل، كما يجب ألا تستبدل الأحداث الأقدم حالة أحدث مؤكدة. أجرِ استعلاماً جديداً عند اختلاف بيانات REST عن تحديثات البث. الحقل v في الرسالة معرّف على أنه إصدار الحساب؛ ولا تضمن الوثائق وجود تسلسل متصل للطلبات أو مؤشر لإعادة التشغيل. لذلك، لا يكفي وجود فجوة في الإصدار لتحديد طلب مفقود.
إذا لم تستمر التحديثات في الوصول، فاتبع العَرَض
| العَرَض | ما ينبغي التحقق منه |
|---|---|
يعيد الاتصال الأولي الرمز 403 | تحقق من User-Agent، ثم من حقول المصادقة الأخرى. يذكر قسم الأسئلة الشائعة الرسمي أن جدار الحماية يحظر الاتصالات التي تفتقر إلى هذا الترويسة. |
| تم الاتصال، لكن لم يصل إقرار ناجح بالاشتراك | تحقق من العنوان الخاص وطلب orders وأي خطأ في الإقرار. |
| تم الاشتراك، لكن لا تصل أحداث طلبات جديدة | تحقق من نبضات القلب ونشاط الحساب الفعلي. قد يكون هدوء تدفق البيانات متوقعاً عند عدم وجود تغييرات جديدة على الطلبات. |
| أعاد SDK الاتصال، لكن الحالة المحلية لا تزال مختلفة | تحقق من مطابقة بيانات REST خلال فترة الانقطاع. لا يعني إعادة الاتصال تلقائياً أن حالة الطلبات قد تمت مطابقتها. |
أثناء الاستعادة، تجنب اعتبار غياب الاستجابة دليلاً على فشل الطلب، وتجنب إعادة إرسال كل الطلبات. حدّد الحالة الفعلية للحساب، وعالج الاختلافات، ثم استأنف الاستراتيجيات التي تعتمد عليها.
للحصول على مزيد من المساعدة، استخدم روابط الدعم في الأسئلة الشائعة الرسمية حول API، وقدّم أوقات الاتصال ورموز الحالة والسجلات بعد تنقيحها لتوضيح الموضع الذي توقفت عنده عملية الاستعادة.