الاتصال، الاشتراك والنبض

اتصل ببث 6MM WebSocket ، اشترك في المواضيع، حافظ على الاتصالات، ومعالجة أظرف الرسائل بأمان.

View as Markdown

استخدم تدفقات WebSocket لبيانات السوق وتحديثات حالة المستخدم الخاصة التي يجب أن تبقى محدثة دون إجراء استطلاعات.

URL الاتصال

wss://ws.6mm.com/ws

تتطلب التدفقات الخاصة سياق مصادقة مثل listenKey أو رمز الوصول كما هو موضح في وثائق القناة الخاصة.

اشترك

1{ "id": "1772007814666", "op": "subscribe", "args": ["market.depth.BTCUSDT"] }

تأكيد الاشتراك الناجح:

1{
2 "id": "1772007814666",
3 "event": "subscribe",
4 "success": true,
5 "data": ["market.depth.BTCUSDT"]
6}

إلغاء الاشتراك

1{ "id": "1772007814667", "op": "unsubscribe", "args": ["market.depth.BTCUSDT"] }

تصغير التطبيق

1{ "id": "1772007814668", "op": "ping", "args": [] }

ظرف الرسالة

الدفع العام يستخدم ظرفا ثابتا:

1{
2 "topic": "market.depth.BTCUSDT",
3 "event": "data",
4 "ts": 1772007815000,
5 "data": {}
6}

التوصيات التشغيلية

  • إنشاء id فريد على جانب العميل لكل طلب اشتراك، إلغاء اشتراك، وطلب ping.
  • اعتبر إعادة الاتصال كجلسة جديدة وأعد الاشتراك في المواضيع المطلوبة.
  • التحقق من أن topic المردود يطابق القناة التي تتوقعها خدمتك.
  • الحفاظ على معالجة الرسائل ذات القدرة الذاتية عندما يتعلق الأمر بأوامر خاصة أو أحداث حساب.
  • تسجيل تغييرات حالة الاتصال، تأكيدات الاشتراك، والانقطاعات غير الطبيعية.

إعادة ربط سير العمل

  1. أغلق أو تخلص من المقبس السابق وأنشئ اتصالا جديدا.
  2. إعادة التحقق من صحة التدفقات الخاصة باستخدام listenKey أو رمز وصول صالح.
  3. أعد الاشتراك في كل موضوع مطلوب وانتظر التقدير الناجح.
  4. استبدال الولاية المحلية في دفتر الأوامر بصورة جديدة قبل تطبيق تحديثات تدريجية.
  5. التوفيق بين الأوامر المفتوحة والمواقف والتوازنات من خلال REST إذا كان قد فاتت الأحداث الخاصة.

استخدم ارتداد أسي محدود مع التذبذب لمحاولات إعادة الاتصال. يجب على العميل الذي يعيد الاتصال بشكل مستمر تنبيه المشغلين بدلا من إعادة المحاولة إلى أجل غير مسمى دون رؤية واضحة.

نبض القلب والروابط القديمة

  • تتبع أحدث رسالة واردة وتأكيد ناجح للتنبيه.
  • استخدم فترة نبض القلب وعتبة الخمول المعتمدة لبيئة الإنتاج.
  • عامل الاتصال على أنه قديم عندما يتجاوز الحد المكون، حتى لو كان مقبس TCP لا يزال مفتوحا.
  • لا تعيد استخدام الاشتراكات من مقبس قديم؛ أعد الاشتراك بشكل صريح بعد كل إعادة اتصال.
  • [قنوات السوق العامة] (/developer-api/websocket/public-market-channels): المواضيع، استمرارية دفتر الطلبات، التداولات، الشموع، والنشرات.

  • [قناة المستخدم الخاصة] (/developer-api/websocket/private-user-channel): دورة حياة listenKey والأحداث المصادقة.

  • [توصيات التكامل] (/developer-api/integration-recommendations): المحاولات، التقدير، المراقبة، واختبار الإطلاق.
  • WebSocket قنوات بيانات السوق العامة

  • قناة المستخدم الخاص

  • توصيات التكامل