错误消息参考

调用接口时，如果请求失败，msg 字段会返回具体的错误消息。本页汇总了所有可能的错误及其排查方法。

---

通用错误

所有接口都可能返回的错误。

{ "code": 201, "msg": "错误的调用" }

接口路径不存在或调用方式错误。 请检查请求的 URL 路径是否拼写正确，确保使用 POST 方法。

{ "code": 201, "msg": "程序未开启" }

程序处于关闭状态。 在后台「程序管理」中启用该程序。

{ "code": 201, "msg": "接口未开启" }

该接口未启用。 在后台「API 管理」中启用对应接口。

{ "code": 201, "msg": "时间戳参数不可为空" }

后台开启了时间戳验证，但请求未传 t 参数。 在请求体中加上 t 参数，值为 10 位秒级 Unix 时间戳。

{ "code": 201, "msg": "验证数据已失效，请重试" }

时间戳校验失败。 这是最常见的对接错误，可能有多个原因：

刚开始对接就报错？

• 加密算法、密钥与后台传输配置不一致，导致服务器解密失败 —— 请逐项核对算法类型、密钥、请求值编码
• t 参数不是 10 位秒级时间戳 —— 不要传毫秒级（13 位）或日期字符串

已运行一段时间突然报错？

• 用户设备时间不准确，与服务器偏差超过 30 秒 —— 提示用户开启「自动设置时间」

{ "code": 201, "msg": "签名参数不可为空" }

后台开启了签名验证，但请求未传 s 参数。 按照 签名校验 算法计算签名后传入。

{ "code": 201, "msg": "签名有误" }

签名值与服务器计算结果不一致。 检查签名计算逻辑：参数排序、拼接方式、MD5 编码（32 位小写）是否正确。

---

卡密相关

{ "code": 201, "msg": "卡密不可为空" }

未传 kami 参数。 请在请求体中传入卡密。

{ "code": 201, "msg": "卡密不存在" }

该卡密值不存在或已被删除。 确认卡密是否拼写正确、是否已在后台生成。

{ "code": 201, "msg": "卡密被禁用" }

卡密被后台手动禁用。 在后台「卡密管理」中解除禁用。

{ "code": 201, "msg": "卡密已到期" }

卡密已过期。 需要续费或使用新卡密。

{ "code": 201, "msg": "卡密未激活" }

卡密从未登录使用过。 此错误出现在查询等场景中，表示该卡密尚未被首次使用。

{ "code": 201, "msg": "卡密使用次数已达上限" }

次卡的可用次数已耗尽。 需要续充次数或更换卡密。

{ "code": 201, "msg": "卡密禁止登录" }

后台开启了「机器码为空时禁止登录」，但该卡密尚未绑定设备。 需要先在后台为卡密绑定机器码。

---

用户相关

{ "code": 201, "msg": "用户名不可为空" }

未传 user 参数。

{ "code": 201, "msg": "密码不可为空" }

未传 pass 参数。

{ "code": 201, "msg": "用户名只能为英文或数字" }

用户名包含非法字符。 仅允许英文字母和数字。

{ "code": 201, "msg": "用户名不可低于6位" }

用户名长度不足 6 位。

{ "code": 201, "msg": "密码不可低于6位" }

密码长度不足 6 位。

{ "code": 201, "msg": "用户名密码不可相同" }

用户名和密码不能相同。 请使用不同的密码。

{ "code": 201, "msg": "邮箱填写错误" }

邮箱格式不合法。 请确保传入正确格式的邮箱地址。

{ "code": 201, "msg": "用户已存在" }

注册时用户名已被占用。 换一个用户名重试。

{ "code": 201, "msg": "邮箱已存在" }

注册时邮箱已被使用。 换一个邮箱或找回已有账号。

{ "code": 201, "msg": "已达注册上限" }

同一 IP 注册次数已达后台设定的上限。 这是防滥注册的限制。

{ "code": 201, "msg": "用户不存在" }

该用户名不存在。 请确认用户名是否拼写正确。

{ "code": 201, "msg": "用户名或密码错误" }

密码不正确。 注意密码区分大小写。

{ "code": 201, "msg": "用户被禁用" }

用户被后台禁用。 在后台解除禁用状态。

{ "code": 201, "msg": "请先充值后使用" }

用户未充值激活。 使用充值卡密为该用户充值后即可登录。

{ "code": 201, "msg": "用户使用时间已到期" }

用户账号已过期。 需要续费充值。

{ "code": 201, "msg": "用户未激活" }

用户尚未充值激活。 查询类接口返回此错误，说明账号还没有充值记录。

---

设备 / IP 相关

{ "code": 201, "msg": "机器码不可为空" }

后台开启了机器码验证，但请求未传 imei 参数。

{ "code": 201, "msg": "机器码不合法，因为存在'号" }

机器码中包含单引号 ' 字符。 请清理机器码中的特殊字符后重试。

{ "code": 201, "msg": "请在原设备登录" }

当前机器码与绑定的不一致。 该卡密/用户已绑定其他设备，需要先解绑。

{ "code": 201, "msg": "请在原IP登录" }

当前 IP 与绑定的 IP 不一致（精确模式）。 需要在原始 IP 地址下登录，或先解绑 IP。

{ "code": 201, "msg": "请在原省内登录" }

当前 IP 不在绑定地区同省（省级模式）。 切换到同省网络或解绑 IP。

{ "code": 201, "msg": "请在市内登录" }

当前 IP 不在绑定地区同市（市级模式）。 切换到同市网络或解绑 IP。

---

解绑相关

{ "code": 201, "msg": "程序未开启机器码验证" }

程序没有开启机器码验证功能，无需解绑。

{ "code": 201, "msg": "程序未开启IP验证" }

程序没有开启 IP 验证功能，无需解绑 IP。

{ "code": 201, "msg": "程序未开启卡密解绑" }

后台未开启解绑功能。 需要在后台「程序设置」中启用解绑。

{ "code": 201, "msg": "机器码一样，无需解绑" }

新旧机器码一致，无需解绑。 当前设备就是绑定设备。

{ "code": 201, "msg": "解绑次数超过限制" }

已达到后台设定的最大解绑次数。 需联系开发者处理。

{ "code": 201, "msg": "解绑失败，近X小时内解绑次数已达Y次上限" }

限定时间窗口内的解绑次数已用完。 等待冷却时间过后再试。

{ "code": 201, "msg": "解绑后将到期" }

解绑需扣除时长，但扣除后剩余时间不足。 需要先续费再解绑。

---

心跳相关

{ "code": 201, "msg": "状态码不可为空" }

未传 statecode 参数。 使用登录接口返回的 statecode 值。

{ "code": 201, "msg": "状态码不存在" }

statecode 格式错误（长度不是 32 位）。 确保传入的是登录时返回的完整 statecode。

{ "code": 201, "msg": "登录状态不存在" }

该 statecode 在心跳记录中不存在。 可能是服务器重启后记录丢失，需要重新登录。

{ "code": 201, "msg": "登录状态失效" }

登录状态被标记为失效。 通常是因为在另一台设备登录导致被挤下线，需要重新登录。

{ "code": 201, "msg": "登录状态已过期" }

超过「登录状态码有效期」未调用心跳。 心跳间隔太长，需缩短心跳频率或重新登录。

---

其他错误

{ "code": 201, "msg": "充值卡不可为空" }

未传 card 参数。

{ "code": 201, "msg": "充值卡不存在" }

充值卡密不存在。 确认卡密是否拼写正确。

{ "code": 201, "msg": "充值卡已封禁" }

充值卡被后台封禁。 在后台解除封禁。

{ "code": 201, "msg": "充值卡已使用" }

充值卡已被使用过。 每张充值卡只能使用一次。

{ "code": 201, "msg": "变量ID不可为空" }

未传 valueid 参数。

{ "code": 201, "msg": "变量数据不存在" }

指定 ID 的变量不存在。 确认 valueid 是否正确。

{ "code": 201, "msg": "变量被禁用" }

该远程变量被后台禁用。 在后台「变量管理」中启用。

{ "code": 201, "msg": "文档不存在" }

云文档 Token 不存在。 确认 token 值是否正确。

{ "code": 201, "msg": "文档未启用" }

云文档被禁用。 在后台启用该云文档。

{ "code": 201, "msg": "应用签名与开放平台填写不一致" }

客户端传入的签名值与后台配置的不匹配。 确认 autograph 值是否与后台填写的一致。

{ "code": 201, "msg": "核心数据不可大于1000字符" }

core 字段长度超过 1000 字符限制。 缩减数据长度，或开通年度会员提升限制。

{ "code": 201, "msg": "使用变量功能需要开发者开通会员" }

远程变量功能需要开发者会员权限。 请先开通会员。

{ "code": 201, "msg": "使用修改变量功能需要开发者开通年度会员" }

修改远程变量需要年度会员权限。 请升级为年度会员。