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

أنشئ listenKey أولا:

1
POST /v1/private/user/listen-key

مثال على الرد:

1
{
2
  "code": 0,
3
  "message": "success",
4
  "data": {
5
    "listenKey": "f57cb61ef604ce76be09e753a5dbdd8c",
6
    "expireAt": 1777539918867
7
  },
8
  "requestId": "req-listen-key"
9
}

listenKey صالحة لمدة 60 دقيقة بشكل افتراضي. يوصى بالتجديد كل 30 دقيقة.

تجديد

1
PUT /v1/private/user/listen-key
2
Content-Type: application/json

1
{ "listenKey": "f57cb61ef604ce76be09e753a5dbdd8c" }

إغلاق

1
DELETE /v1/private/user/listen-key
2
Content-Type: application/json

1
{ "listenKey": "f57cb61ef604ce76be09e753a5dbdd8c" }

اتصل ب WebSocket

wss://ws.6mm.com/ws?listenKey=YOUR_LISTEN_KEY

طريقة الاتصال JWT المتوافقة:

wss://ws.6mm.com/ws?token=YOUR_ACCESS_TOKEN

بعد نجاح المصادقة، يشترك الخادم تلقائيا في الاتصال بقناة المستخدم الخاصة الحالية. لا يتطلب اشتراكا يدويا.

تأكيد المصادقة الناجح:

1
{ "event": "auth", "success": true, "data": "1188041528" }

الفعاليات الخاصة الشائعة

غلاف الرسالة الدفعية الخاص:

1
{
2
  "topic": "user.5794",
3
  "ts": 1771047000000,
4
  "data": {
5
    "eventType": "ORDER_TRADE_UPDATE"
6
  }
7
}

REST الاستعلام تستخدم نقاط نهاية التدفقات الخاصة WebSocket مخططات منفصلة. يجب على العملاء تحليل كل مخطط بشكل مستقل وعدم افتراض أن أسماء الحقول متطابقة.

الاختلافات الشائعة

التعافي والمصالحة

• تجديد listenKey قبل انتهاء الصلاحية وإنشاء جديد إذا فشل التجديد.
• إعادة الاتصال، وإعادة المصادقة، والتعامل مع المقبس الجديد كجلسة حدث جديدة.
• إلغاء تكرار الأحداث قبل تغيير أرصدة الشركاء أو سجلات الأوامر.
• إذا كان قد فاتت أحداث، استفسر عن الأوامر ، المراكز وحالة الحساب عبر REST.
• اتبع دليل الاتصال ونبض القلب لإعادة المحاولة والتعامل مع الاتصال الراكد.