通用参数和错误码
T3网络验证 V3 API - 通用参数和错误码
通用请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| timestamp | int | 条件必填 | Unix时间戳（秒），开启TimeCheck时必填 与服务器时间差不超过30秒 |
| sign | string | 条件必填 | 请求签名（MD5，32位小写），开启SignMode时必填 算法见"加密和签名算法"文档 |
通用响应字段
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码，200=成功，其他=失败 |
| message | string | 响应消息 |
| data | object/string/null | 业务数据 • 成功时：业务数据对象 • 失败时：null • DataEncrypt开启时：加密字符串 |
| timestamp | int | 服务器Unix时间戳（秒） |
| nonce | string | 随机数，用于签名验证（32位MD5） |
| sign | string | 响应签名（单向），SignMode≥1时返回 |
| sign2 | string | 响应签名（双向），仅SignMode=2时返回 |
| data_encrypted | int | data是否加密的标识，仅DataEncrypt=true时返回，值为1 |
{
"code": 200,
"message": "成功",
"data": {
// 业务数据
},
"timestamp": 1699999999,
"nonce": "abc123def456...",
"sign": "def456ghi789...",
"sign2": "ghi789jkl012..."
}错误码对照表
通用错误码
| 错误码 | 错误消息 | 说明 | 处理建议 |
|---|---|---|---|
| 200 | 成功 | 请求处理成功 | 正常处理业务数据 |
| 400 | 请求错误 | 请求格式错误或参数错误 | 检查请求参数格式 |
| 401 | 程序不存在 | AppID不存在或已被删除 | 检查AppID配置 |
| 402 | 程序已封禁 | 程序被管理员封禁 | 联系程序开发者 |
| 408 | 程序已停用 | 程序已被停用 | 联系程序开发者 |
| 422 | 参数错误 | 缺少必要参数或参数格式错误 | 检查传入参数 |
| 423 | 时间戳错误 | 时间戳验证失败 | 检查系统时间是否正确 |
| 424 | 签名错误 | 签名验证失败 | 检查AppKey配置 |
| 425 | 用户不存在 | 开发者账号不存在 | 联系系统管理员 |
| 426 | 用户已封禁 | 开发者账号被封禁 | 联系系统管理员 |
| 427 | IP不匹配 | IP验证失败 | 检查IP限制 |
| 428 | 接口不存在 | API接口不存在 | 检查接口路径 |
卡密相关错误码
| 错误码 | 错误消息 | 说明 | 处理建议 |
|---|---|---|---|
| 404 | 卡密不存在 | 卡密不存在或已被删除 | 提示用户检查卡密 |
| 405 | 卡密已禁用 | 卡密已被封禁 | 提示用户联系客服 |
| 406 | 卡密已过期 | 卡密使用时长已到期 | 提示用户续费 |
| 407 | 卡密未激活 | 卡密还未首次登录 | 提示用户先登录 |
| 408 | 卡密次数已用完 | 次数卡次数已用完 | 提示用户续费 |
| 430 | 卡密登录被禁止 | 空机器码登录被禁止 | 提供设备码 |
设备相关错误码
| 错误码 | 错误消息 | 说明 | 处理建议 |
|---|---|---|---|
| 409 | 设备不匹配 | 当前设备与绑定设备不一致 | 提示用户解绑或联系客服 |
| 410 | 需要设备标识 | 程序开启了设备验证，必须传入device_code | 传入device_code参数 |
| 411 | 机器码验证未开启 | 程序未开启设备验证功能 | 无法使用解绑功能 |
| 416 | 设备相同 | 解绑时新设备与旧设备相同 | 更换不同的设备码 |
解绑相关错误码
| 错误码 | 错误消息 | 说明 | 处理建议 |
|---|---|---|---|
| 412 | 解绑功能未开启 | 程序未开启解绑功能 | 联系程序开发者 |
| 417 | 解绑次数已达上限 | 解绑次数用完 | 提示用户联系客服 |
| 418 | 解绑后将到期 | 扣除时间后剩余时长不足 | 提示用户先续费 |
| 419 | 解绑失败 | 数据库更新失败 | 稍后重试 |
心跳相关错误码
| 错误码 | 错误消息 | 说明 | 处理建议 |
|---|---|---|---|
| 413 | 心跳记录不存在 | 未找到心跳记录，可能未登录 | 先调用登录接口 |
| 414 | 心跳状态失效 | 心跳已失效，可能被其他设备顶号 | 提示用户被顶号，退出程序 |
| 415 | 心跳已过期 | 距离登录时间过久 | 提示用户重新登录 |
变量相关错误码
| 错误码 | 错误消息 | 说明 | 处理建议 |
|---|---|---|---|
| 403 | 需要VIP权限 | 开发者VIP已到期，无法使用变量功能 | 联系程序开发者 |
| 420 | 变量不存在 | 变量ID或名称不正确 | 检查变量ID和名称 |
| 421 | 变量已禁用 | 变量已被停用 | 联系程序开发者 |
错误处理示例
C++ SDK错误处理
心跳失败处理
常见问题
Q: 如何判断错误类型？
Q: 签名验证失败怎么办？
1.
2.
3.
Q: 时间戳验证失败？
1.
2.
3.
Q: 网络请求失败？
1.
2.
3.
修改于 2025-11-10 21:03:00