SDK 心跳

SDK 心跳维持登录会话，并接收项目停用、全体下线和强制重新登录等状态。该接口属于官方 SDK 会话链路，不是 Connect 的通用心跳接口。

POSThttps://gnyanzheng.cn/api/v1/cards/heartbeatSDK 卡密会话

请求前提

1. 已通过官方 SDK 的卡密登录取得 session_token。
2. 项目已开通标准 card_login 能力并允许 SDK 接入。
3. 客户端使用 SDK 配置返回的 heartbeat_interval，不要自行缩短为高频轮询。

心跳不重复计算一次登录接口业务次数，但仍会检查对应登录能力是否开通。作者关闭 card_login 或 user_login 后，既有对应会话不能靠心跳继续维持授权。

请求需要携带当前会话令牌和稳定设备码。签名、头部名称及序列化由官方 SDK 处理；自行实现时必须以用户中心当前 SDK 接口详情为准。

POST /api/v1/cards/heartbeat
Authorization: Bearer YOUR_SESSION_TOKEN
Content-Type: application/x-www-form-urlencoded

machine_id=DEVICE_ID

项目	要求
Authorization	必须使用登录返回的 session_token，格式为 Bearer token
machine_id	应与登录时使用的稳定设备码一致
签名与公共头	官方 SDK 自动处理，以当前 SDK 版本协议为准

客户端处理

结果	客户端动作
心跳成功	保持当前授权状态，等待下一个建议间隔
临时网络超时	有限重试，不立即创建新登录会话
会话失效或要求重新登录	立即清除令牌、停止受保护功能并返回登录页
卡密或项目明确不可用	停止重试，向用户显示业务原因
系统错误带 request_id	保留请求 ID，交给作者、客服或管理员排查

全体下线依赖客户端执行

平台会立即让既有会话失效，但无法直接关闭用户设备上的进程。客户端必须在下一次心跳失败时真正退出授权状态，否则界面不会发生变化。

相关接口

• 应用用户会话使用 POST /api/v1/users/heartbeat，不要与卡密会话混用。
• Connect 登录返回的 token 属于独立协议，不能直接传给 SDK 心跳。
• 完整生命周期见登录会话与心跳。