错误代码参考

通用返回结构

所有接口返回统一的 JSON 结构：

{
    "code": "200",
    "message": "",
    "status": true,
    "data": null,
    "pc": null,
    "time": null,
    "sign": null,
    "nonce": null
}

HTTP 状态码

HTTP 状态码	说明
200	请求成功（注意：业务是否成功需看返回 body 中的 code 字段）
500	服务端错误，通常为请求数据解析失败、解密失败或系统内部错误

注意：HTTP 状态码 500 时返回的 body 为明文 JSON 对象，可直接读取错误信息，无需解密。

业务状态码（code 字段）

code	说明
200	请求成功
203	请求无数据（查询类接口没有匹配结果时返回）
403	无权限或 Token 过期，建议跳转登录界面让用户重新登录
500	业务错误（message 字段会携带具体错误信息，可直接展示给用户）

通用业务字段

字段	类型	说明
code	string	业务状态码
message	string	错误信息，成功时为空
status	boolean	状态，true 为成功，false 为失败
data	json/null	返回数据，格式为 JSON
pc	json/null	分页信息（列表查询时返回，非列表时为 null）
time	string	时间戳（开启验签时返回）
sign	string	响应签名（开启验签时返回）
reqSign	string	请求签名（开启验签时返回）
nonce	string	随机字符串（开启验签 V3 时返回）

常见错误场景

场景	HTTP 状态码	code	message 示例
解密失败	500	-	数据解密失败
解析失败	500	-	内容解析失败,请检查提交信息是否正确
Token 过期	200	403	权限异常或登录超时
卡密错误	200	500	卡密错误
用户不存在	200	500	用户不存在
余额不足	200	500	余额不足
查询无数据	200	203	无匹配数据

备注

• 业务错误（如余额不足、用户不存在等）返回 HTTP 200，错误信息在响应 body 中通过 message 字段携带
• 加解密异常仅在开发阶段常见，正式环境出现通常是开发者更换了密钥导致
• 上传文件的接口不支持加解密（不含 base64）