心跳保活
heartbeat
刷新已绑定设备的心跳,延长在线会话。
请求体与 verify 相同(公共请求体)。device_name、client_meta 可省略,服务端忽略。
成功时返回与 verify 同结构的运行时响应(payload / signature / encrypted 等)。详见 verify 的 Returns、Runtime Payload,以及 加密与签名。
本接口仅适用于 Volt 卡密云服务。自行搭建服务端不适用(服务端 SDK 尚未开放)。
在策略 heartbeat_enabled = true 时,客户端应按 heartbeat_interval_secs 周期性调用本接口,刷新绑定的 last_seen_at。
调用前提:
active 且未封禁)device_fingerprint 已通过 verify 建立活跃绑定未先 verify 或指纹不一致时,将无法刷新心跳。
成功时 data 形状与 verify 一致,可再次携带更新后的 server_time、session_token 等字段。
heartbeat_interval_secs 为准offline_grace_secs 未心跳时,服务端可能按策略判定离线(具体以服务端策略为准)