错误码

1. 错误码对照表 (Error Codes)

当接口调用失败时，响应体中会包含对应的 code 和 msg。请参考下表定位问题：

1.1 公共参数缺失 (Header 相关)

这类错误通常是因为请求头（Header）未正确携带必要的鉴权字段。

错误码 (Code)	描述 (Message)	解决方案
1001	缺少参数 X-APP-ID	请在 Header 中添加 X-APP-ID 字段
1002	缺少参数 X-NONCE	请在 Header 中添加 X-NONCE 字段
1003	缺少参数 X-TIMESTAMP	请在 Header 中添加 X-TIMESTAMP 字段
1004	缺少参数 X-SIGN	请在 Header 中添加 X-SIGN 签名字段

1.2 身份与权限校验

涉及账户有效性、API 权限及网络安全。

错误码 (Code)	描述 (Message)	解决方案
1005	APP_ID 不存在	请检查 appId 是否输入正确，或前往后台确认已创建
1006	账户已禁用	您的账户已被锁定，请联系客服处理
1007	当前IP禁止访问	请在后台“IP白名单”配置中添加您当前的服务器 IP

1.3 安全验证

涉及签名算法、时钟同步等安全校验。

错误码 (Code)	描述 (Message)	解决方案
2000	时间戳已过期	请确保服务器时间与标准时间同步，允许误差范围为 5 分钟
2001	签名验签失败	1. 核对 key；2. 检查拼接顺序；3. 确保 MD5 后为小写

1.4 错误响应示例

如果签名计算错误，接口将返回如下 JSON：

{
    "code": 2001,
    "msg": "签名验签失败",
    "data": null
}