Kênh Người dùng Riêng tư

Tạo listenKey trước:

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

Ví dụ phản hồi:

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

listenKey mặc định có hiệu lực trong 60 phút. Khuyến nghị gia hạn mỗi 30 phút.

Gia hạn

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

1
{ "listenKey": "f57cb61ef604ce76be09e753a5dbdd8c" }

Đóng

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

1
{ "listenKey": "f57cb61ef604ce76be09e753a5dbdd8c" }

Kết nối với WebSocket riêng tư

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

Phương thức kết nối JWT tương thích:

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

Sau khi xác thực thành công, máy chủ sẽ tự động đăng ký kết nối đến kênh riêng tư của người dùng hiện tại. Không cần đăng ký thủ công.

Xác nhận xác thực thành công:

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

Các sự kiện riêng tư phổ biến

Bao bọc tin nhắn đẩy riêng tư:

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

REST đầu cuối truy vấn và luồng riêng tư WebSocket sử dụng các lược đồ riêng biệt. Khách hàng nên phân tích từng lược đồ độc lập và không nên giả định tên trường giống hệt nhau.

Những điểm khác biệt chung

Phục hồi và hòa giải

• Gia hạn listenKey trước khi hết hạn và tạo mới nếu gia hạn thất bại.
• Kết nối lại, xác thực lại và coi socket mới như một phiên sự kiện mới.
• Loại bỏ trùng lặp sự kiện trước khi thay đổi số dư đối tác hoặc bản ghi đơn hàng.
• Nếu có thể đã bỏ sót sự kiện, hãy truy vấn orders, positions, và trạng thái tài khoản qua REST.
• Làm theo hướng dẫn kết nối và nhịp tim để thử lại và xử lý kết nối bị trì hoãn.