心跳 (action=heartbeat)

保持在线状态,按 heartbeat_interval 间隔定时发送。心跳会刷新会话有效期,并返回最新的用户状态。

请求参数

参数名类型必填说明
actionstring固定值 heartbeat
tokenstring登录时获取的令牌
machine_codestring建议机器码,用于验证一致性
timestampint时间戳

成功响应 (code=3)

字段名类型说明
timestampint服务器时间戳
expire_timestring最新到期时间
pointsint最新点数
balancefloat最新余额
exec_tokenstring新的执行令牌(每次心跳轮换)

可能的错误码

错误码说明处理建议
3001心跳参数错误检查参数
3002token无效重新登录
3003token已过期重新登录
3004机器码不匹配可能被盗用,强制下线
3005账号已被禁用联系管理员
3006账号已过期提示充值
心跳间隔建议使用init返回的heartbeat_interval值,通常为30秒。连续3次心跳超时会话将失效。

请求示例

action=heartbeat&machine_code=ABC123×tamp=1700000000&token=eyJhbGciOiJIUzI1NiIs...

响应示例

{
    "code": 3,
    "msg": "心跳成功",
    "timestamp": 1700000001,
    "expire_time": "2024-12-31 23:59:59",
    "points": 95,
    "balance": 10.50,
    "exec_token": "newtoken123"
}