❌ 错误码说明(Error Codes)

用于描述 WebSocket 和 HTTP 请求中的错误类型及其含义。

以下是可能存在的错误码,错误码返回,参考返回内容进行查询,返回内容会直接提示响应错误。

💻 WS 错误码
错误码
1 无效密钥
2 密钥过期
3 没有订阅权限
4 超出最大订阅限制
5 超出最大连接限制
6 没有心跳,断开连接
7 订阅产品成功
8 取消订阅产品成功
9 按交易所订阅成功
📌 WS 错误码说明:
无效密钥:表示提供的 API 密钥无效,可能是未授权或格式错误。
密钥过期:提供的 API 密钥已过期,需要重新获取。
没有订阅权限:请求的订阅操作没有权限执行,可能是用户账户限制。
超出最大订阅限制:已达到允许订阅的最大数量,无法再添加新的订阅。
超出最大连接限制:已达到连接数限制,无法再创建新连接。
没有心跳,断开连接:连接因未发送心跳信号被服务端主动断开。
订阅产品成功:订阅产品操作成功,开始接收相关数据。
取消订阅产品成功:成功取消订阅,停止接收相关数据。
按交易所订阅成功:按指定交易所成功订阅,开始接收数据。
🌐 HTTP 错误码
错误码 描述
1 次数不足
2 没有权限
3 返回超时
4 密钥过期
5 无效密钥
📌 HTTP 错误码说明:
次数不足:请求次数已达到限制,可能是频率过高或达到配额。
没有权限:请求的资源或操作无权访问,可能是身份验证失败或权限不足。
返回超时:请求超时,服务器未及时返回结果,可能是网络或服务器问题。
密钥过期:提供的 API 密钥已过期,无法继续使用。
无效密钥:提供的 API 密钥无效,无法进行操作。
💡 开发建议
API 密钥管理:定期检查 API 密钥的有效期,确保在密钥过期之前进行更新。
错误处理:建议在客户端处理所有错误码,提供用户友好的错误提示。
连接与订阅管理:针对最大连接数限制和最大订阅数限制,提前规划用户的使用情况,避免遇到超限错误。
心跳机制:实现心跳机制,避免因心跳丢失导致连接断开。