错误码

WebSocket 交易推送涉及通道错误码，由 WebSocket 通道层返回，发生在鉴权或底层请求处理阶段。码值为 4xxx / 5xxx 的整数。

通道错误码

通道错误发生在请求到达业务逻辑之前，由 WebSocket 网关或鉴权服务返回。

json

{
  "id": "req-001",
  "code": 4002,
  "msg": "auth_failed"
}

code	含义	常见原因	处理建议
`4000`	请求格式错误	发送的帧结构不符合协议，如 JSON 格式有误、`action` 字段为空。	检查请求帧格式，修复后重新发送。
`4001`	尚未完成鉴权	在鉴权成功之前发送了业务请求。	先完成 Auth 鉴权，收到 `session_id` 后再发送业务请求。
`4002`	鉴权失败	`credential_id` 不存在、签名验证不通过、Bearer Token 已过期或无效。	检查凭证和签名逻辑；OAuth2 场景需先刷新 Token 再重新建立连接。
`4003`	权限不足	当前凭证的授权范围（scope）不包含所请求的接口权限。	确认所用凭证是否已授权该接口；如使用 OAuth2，检查授权时申请的 scope。
`4004`	接口不存在	`action` 填写有误，或请求了服务端未开放的接口。	核对接口文档，确认 `action` 名称拼写正确。
`5000`	服务内部错误	服务端处理请求时发生意外异常。	可联系服务端排查；不建议自动重试。
`5002`	网关错误	服务端网络异常，请求未能送达后端。	稍后重试；持续出现请检查网络环境或联系服务端。
`5003`	服务暂时不可用	服务端负载过高，暂时无法处理新请求。	等待片刻后重试，建议加退避策略。
`5004`	请求超时	服务端处理超时，未能在规定时间内返回结果。	稍后重试；持续超时请联系服务端排查。