📡 2. 连接

🔗 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"}

📖 说明
收到该消息后,才可以进行订阅操作
若未收到该消息,说明连接未成功