单码心跳验证 POST

单码卡密登录后定期调用，维持在线状态。超时未调用将被视为离线。

请求方法： POST　　Content-Type： application/x-www-form-urlencoded

💡 SDK 快速接入

官方 SDK 已支持此接口，您可以直接使用 SDK 一键调用，无需手动处理加密和签名。

Python Node.js Java C#C C++PHP Objective-C Swift Web JS

对接示例也已支持此接口

Android 全屏验证 Android 弹窗验证 iOS 全屏验证 iOS 弹窗验证 Android JNI 命令行 C++ 命令行

SDK 调用示例

python

result = verify.heartbeat(card, statecode)
if result['success']:
    print("心跳验证成功")

javascript

const result = await verify.heartbeat(card, statecode);
if (result.success) console.log('心跳验证成功');

java

T3Verify.T3Result result = verify.heartbeat(card, statecode);
if (result.success) System.out.println("心跳验证成功");

csharp

var result = verify.Heartbeat(card, statecode);
if (result.Success) Console.WriteLine("心跳验证成功");

cpp

auto result = verify.heartbeat(card, statecode);
if (result.success) std::cout << "心跳验证成功" << std::endl;

php

$result = $verify->heartbeat($card, $statecode);
if ($result['success']) echo "心跳验证成功\n";

swift

let result = verify.heartbeat(kami: card, statecode: statecode)
if result.success { print("心跳验证成功") }

调用时机

登录成功后，按「登录状态码有效期」内定期调用。建议间隔为有效期的 1/2 ~ 2/3。

例如有效期为 60 秒，则每 30 ~ 40 秒调用一次。

请求参数

参数	类型	必填	说明
`statecode`	`string`	必填	登录时返回的 `statecode` 值（32 位字符串）
`t`	`number`	条件必填	秒级 Unix 时间戳
`s`	`string`	条件必填	请求签名
`safe_code`	`string`	可选	数据验证码

成功响应

JSON 格式文本格式

jsonc

{
  "code": "200",             // 状态码
  "msg": "在线",              // 结果消息
  "time": 1741700000,        // 服务器时间戳
  "date": "202603111200"     // 服务器日期分钟
}

txt

在线
当前时间:202603111200
当前时间戳:1741700000

错误列表

心跳错误

错误消息	原因
`状态码不可为空`	未传 `statecode`
`状态码不存在`	`statecode` 长度不是 32 位
`登录状态不存在`	`statecode` 在心跳记录中不存在
`登录状态失效`	登录状态被标记失效（可能被挤下线）
`登录状态已过期`	超过有效期未调用心跳
`卡密已到期`	卡密已过期
`卡密被禁用`	卡密被后台禁用

通用错误

错误消息	原因
`程序未开启` / `接口未开启`	程序或接口未启用
`时间戳参数不可为空`	开启时间戳验证但未传 `t`
`验证数据已失效，请重试`	时间戳校验失败（排障指南）
`签名参数不可为空`	开启签名验证但未传 `s`
`签名有误`	签名校验失败

单码心跳验证 POST ​

SDK 调用示例 ​

请求参数 ​

成功响应 ​

错误列表 ​

心跳错误 ​

通用错误 ​