阿越云验证 - 内测版

卡密心跳保活，客户端定时调用以维持在线上状态

接口地址 httpss://skyayue.top/api.php?api=heartbeat

返回格式 JSON

请求方式 POST

请求示例 {SITE}/api.php?api=heartbeat&app={APPID}

请求参数说明

名称	变量	必填	类型	说明
接口	api	是	GET	填写heartbeat
应用	app	是	GET	填写后台应用APPID
卡密	kami	是	GET/POST	填写已登录的卡密
设备码	markcode	是	GET/POST	填写登录时的设备码；传 quit 表示主动退出心跳
时间戳	t	否	GET/POST	如果开启了[时间差效验]需提交此项
数据签名	sign	否	GET/POST	如果开启了[数据签名]需提交此项

返回参数说明

名称	类型	说明
code	String	返回状态
message	String	心跳结果提示
expires	String	卡密到期时间（日期格式）
expires_ts	String	卡密到期时间戳

返回示例

{
    "code": 200,
    "msg": {
        "message": "心跳请求成功",
        "expires": "2099-12-31 23:59:59",
        "expires_ts": "4102243200"
    },
    "time": 1735689600,
    "check": "a1b2c3d4e5f60718293a4b5c6d7e8f90"
}

错误码格式说明

名称	类型	说明
101	String	应用不存在
102	String	应用已关闭
171	String	接口维护中
172	String	接口未添加或不存在
100	String	应用配置未加载
104	String	签名为空
106	String	签名有误
107	String	数据为空或解密失败
112	String	设备码为空
148	String	卡密为空
149	String	卡密不存在
150	String	心跳频率超限
151	String	卡密已被封禁
153	String	心跳间隔超时，连接已失效
201	String	心跳失败（卡密到期等）

代码示例

// PHP 示例：卡密登录成功后，每 30 秒调用一次心跳
// 客户端正常退出时传 markcode=quit 立即标记离线

$config = [
    'base_url' => 'https://你的域名',
    'app_id'   => 10000,
    'app_key'  => '后台获取的APPKEY',
    'rc4_key'  => '后台获取的通信密钥',
    'mi_type'  => 0,      // 0=明文 1=RC4
    'sign'     => false,
];

require 'AyueVerify.php';
$c = new AyueVerify($config);

// 1) 先登录拿到授权
$r = $c->login('你的卡密', '客户端设备码');
if (!$r['ok']) { die('登录失败: ' . $r['msg']); }

// 2) 心跳保活（建议 30~60 秒一次）
while (true) {
    sleep(30);
    $hb = $c->heartbeat('你的卡密', '客户端设备码');
    if (!$hb['ok']) {
        // code=201 卡密到期 / 153 心跳超时 / 150 频率超限
        die('心跳失败: ' . $hb['msg']);
    }
    echo "在线，到期时间: " . date('Y-m-d H:i:s', $hb['expires_ts']) . "\n";
}

// 3) 客户端正常退出时
// $c->heartbeatQuit('你的卡密');