🔗 2.1 连接地址
WebSocket 连接地址格式如下:
ws://jk1.jkidata.com:port/api/json/your_key
📌 参数说明
-> your_key : 用户 API Key(由服务端提供)
-> port : 连接端口号
⚠️ 使用说明
将 your_key 替换为实际获取的 API Key
将 port 替换为对应的连接端口
🌐 2.2 节点说明
不同服务器节点对应的网络线路和性能可能存在差异,例如:
-> 网络延迟
-> 数据推送速度
-> 连接稳定性
🔐 2.3 连接限制说明
当客户端建立 WebSocket 连接时,如果当前 API Key 已达到最大连接限制,服务端将返回如下提示:
📥 返回示例
{ "type": "connect", "msg": "This access key has been used on 1 devices (maximum limit reached). Please disconnect unused sessions or contact the administrator to increase the limit." }
📌 说明
-> 每个 API Key 同时仅允许建立有限数量的连接(默认 1 个)
-> 当达到最大连接数时,新的连接请求将被拒绝
⚠️ 常见原因
已在其他设备或程序中建立连接
上一次连接异常断开(未正常关闭)
客户端未发送断开指令
💡 处理建议
检查是否存在其他活跃连接并主动断开
确认客户端在退出时发送关闭连接请求
若为异常断开或确认所有连接已关闭,建议等待约 5 分钟后再次尝试连接
💻 开发建议
建议在客户端维护连接状态,避免重复连接
建议实现断线自动重连(带延迟机制)
建议在关闭程序时主动断开 WebSocket 连接
避免短时间内频繁重连
⚡ 建议
根据业务需求选择合适节点
高频行情系统建议使用低延迟线路
如需专属节点或优化线路,请联系服务提供方
✅ 2.4 连接成功
当 WebSocket 连接建立成功后,服务端将返回确认信息:
{"type": "connect", "msg": "ok"}
📖 说明
收到该消息后,才可以进行订阅操作
若未收到该消息,说明连接未成功