单码卡密心跳验证
单码心跳验证 API
基本信息
/v3/single_heartbeat/{appid}请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| card_code | string | 是 | 卡密（激活码） |
| heartbeat_code | string | 是 | 心跳状态码 登录时返回的heartbeat_code |
| timestamp | int | 条件必填 | Unix时间戳 开启TimeCheck时必填 |
| sign | string | 条件必填 | 请求签名 开启SignMode时必填 |
请求示例
{
"card_code": "ABC123DEF456",
"heartbeat_code": "abc123def456789abcdef123456789abc",
"timestamp": 1699999999,
"sign": "def456ghi789..."
}成功响应 (200)
{
"code": 200,
"message": "心跳验证成功",
"data": {
"heartbeat_valid": true,
"server_timestamp": 1699999999,
"time_since_login": 60,
"heartbeat_timeout": 300,
"remaining_time": 240
},
"timestamp": 1699999999,
"nonce": "abc123...",
"sign": "def456..."
}响应字段说明
| 字段名 | 类型 | 说明 |
|---|---|---|
| heartbeat_valid | bool | 心跳是否有效 true=有效，false=失效 |
| server_timestamp | int | 服务器时间戳 |
| time_since_login | int | 距离登录的时间（秒） |
| heartbeat_timeout | int | 心跳超时时长（秒） 由程序开发者设定 |
| remaining_time | int | 剩余有效时间（秒） = heartbeat_timeout - time_since_login |
错误响应
| 错误码 | 错误消息 | 说明 |
|---|---|---|
| 404 | 卡密不存在 | 卡密不存在 |
| 405 | 卡密已禁用 | 卡密已被封禁 |
| 406 | 卡密已过期 | 卡密已到期 |
| 407 | 卡密未激活 | 卡密还未首次登录 |
| 413 | 心跳记录不存在 | 未找到心跳记录，可能未登录 |
| 414 | 心跳状态失效 | 心跳已失效，可能被其他设备顶号 |
| 415 | 心跳已过期 | 距离登录时间过久，心跳超时 |
| 422 | 参数错误 | 缺少必要参数 |
C++ SDK调用示例
方法签名
自动心跳（推荐）
手动心跳
检查登录状态
使用场景
防止多开
1.
2.
3.
4.
自动验证
注意事项
重要提示 1.必须先调用 single_login获取heartbeat_code2.heartbeat_code在登录响应的data字段中3.建议每30-60秒调用一次心跳验证 4.心跳失败通常说明被其他设备顶号，应立即退出程序 5.推荐使用SDK提供的自动心跳功能 6.免费模式下心跳验证总是返回成功
常见错误处理
心跳记录不存在 (413)
心跳状态失效 (414)
心跳已过期 (415)
自动心跳配置
T3Config.h配置
使用配置
修改于 2025-11-10 21:04:20