外观
错误码对照表
所有接口响应的 code 字段为业务状态码，0 表示成功，非零表示失败。
通用错误码
| 错误码 | 说明 |
|---|---|
| 0 | 调用成功 |
| 400 | 参数错误，请检查请求参数 |
| 404 | 资源未找到 |
| 500 | 服务器错误，请稍后重试 |
签名相关
| 错误码 | 说明 | 建议处理 |
|---|---|---|
| 10010 | 无效的签名 | 检查签名算法实现，参考 签名算法 |
| 10011 | 签名已过期（60 秒有效期） | 检查客户端时钟是否准确 |
| 10013 | 时间戳大于当前服务器时间 | 检查 timestamp 参数 |
| 10014 | 重复的 nonce | 确保每次请求使用唯一 nonce |
卡密相关
| 错误码 | 说明 | 建议处理 |
|---|---|---|
| 10210 | 卡密已过期 | 提示用户续费或更换卡密 |
| 10212 | 卡密已被冻结 | 联系管理员解冻 |
| 10213 | 卡密超过多开上限 | 关闭多余客户端 |
| 10214 | 登录状态已失效 | 重新登录，可能原因：超时未心跳、被挤下线、后台冻结 |
| 10215 | 只能在首次登录绑定的设备上使用 | 在绑定设备上使用 |
| 10216 | 软件未开启解绑设备功能 | 联系开发者开启解绑 |
| 10217 | 超出可绑定设备上限 | 在已绑定设备上使用 |
| 10218 | 卡密不可用（不存在） | 检查卡密是否正确 |
| 10230 | 软件不存在 | 检查 app_key 是否正确 |
| 10240 | 卡密不存在或已被使用 | 充值时使用未激活的卡密 |
| 10241 | 卡密已被使用 | 充值卡密已激活，不可重复使用 |
| 10244 | 不能对未使用的卡密进行充值 | 目标卡密需先激活 |
| 10254 | 解绑密码不正确 | 检查解绑密码 |
| 10255 | 该卡密不可解绑设备 | 联系开发者开启解绑功能 |
| 10256 | 卡密多开配置不相等，不能充值 | 充值卡密的多开配置需一致 |
| 10257 | 卡密剩余时间不足以解绑扣除 | 充值后再解绑 |
用户相关
| 错误码 | 说明 | 建议处理 |
|---|---|---|
| 10242 | 账号已存在 | 更换用户名或直接登录 |
| 10243 | 用户登录密码错误 | 检查密码 |
| 10250 | 用户已到期 | 充值续费 |
| 10252 | 用户已被冻结 | 联系管理员 |
| 10253 | 用户超过多开上限 | 关闭多余客户端 |
试用相关
| 错误码 | 说明 | 建议处理 |
|---|---|---|
| 10401 | 软件未开启试用 | 联系开发者开启试用功能 |
| 10402 | 试用中，请勿重复登录 | 已在试用中，无需重复登录 |
| 10403 | 已试用过了 | 单次试用已使用，购买正式版 |
| 10404 | 请先登录 | 未登录就发心跳，或登录后超 60 秒才发心跳 |
| 10405 | 试用已到期（一次性试用） | 购买正式版 |
| 10406 | 本周期试用已到期（间隔试用） | 等待下一周期 |
| 10407 | 本周期试用次数已用完 | 等待下一周期 |
远程功能相关
| 错误码 | 说明 | 建议处理 |
|---|---|---|
| 10501 | 远程变量不存在 | 检查变量名是否正确 |
| 10521 | 远程数据不存在 | 检查数据 key 是否正确 |
| 10522 | 远程数据 key 已存在 | 使用 update 操作代替 create |
| 10541 | 远程函数不存在 | 检查函数名是否正确 |
| 10542 | 参数必须为 JSON 列表 | params 需为 JSON 数组序列化后的字符串 |
| 10543 | 远程函数调用错误 | 查看 message 字段获取具体错误信息 |
人机验证 / 邮箱
| 错误码 | 说明 | 建议处理 |
|---|---|---|
| 10601 | 需要人机验证 | 完成 Turnstile 验证后重试 |
| 10602 | 人机验证失败 | 刷新验证组件重试 |
| 10603 | 邮箱验证码错误或已过期 | 重新获取验证码 |
| 10604 | 验证码发送过于频繁 | 等待 60 秒后重试 |
| 10605 | 该邮箱已被注册 | 使用其他邮箱或直接登录 |
| 10606 | 该用户名已被注册 | 更换用户名 |
| 10607 | 邮件发送失败 | 稍后重试 |
代理相关
| 错误码 | 说明 | 建议处理 |
|---|---|---|
| 10701 | 邀请不存在 | 检查邀请链接/ID |
| 10702 | 邀请已过期或已处理 | 联系开发者重新邀请 |
| 10703 | 已存在待处理的邀请 | 先处理已有邀请 |
| 10704 | 该代理已绑定此应用 | 无需重复绑定 |
| 10705 | 绑定关系不存在 | 检查绑定 ID |
| 10706 | 代理不存在 | 检查代理 ID |
权限相关
| 错误码 | 说明 | 建议处理 |
|---|---|---|
| 10801 | 无此操作权限 | 联系管理员分配权限 |
| 10802 | 角色不存在 | 检查角色 ID |
| 10803 | 内置角色不可操作 | 内置角色受保护 |
| 10804 | 菜单不存在 | 检查菜单 ID |
加密相关
| 错误码 | 说明 | 建议处理 |
|---|---|---|
| 10901 | RSA 公钥格式错误或位数不足 | 使用 ≥2048 位的 PEM 格式公钥 |
| 10902 | 响应加密失败 | 服务端错误，联系开发者 |
版本相关
| 错误码 | 说明 |
|---|---|
| 10304 | 已经是最新版本 |