Qingpu 设备令牌
设备令牌用于轻铺AI 浏览器扩展和桌面端登录。因为这些客户端无法读取 APay 域名下的 HTTP-only Cookie,所以通过 Bearer Token 标识当前用户。设备令牌不代表订阅、试用、商品、订单、租户或产品权限。
合同
- Token 使用
qpd_前缀,qingpu_device_tokens只保存 SHA-256 哈希,不保存明文。 - 每个用户最多一个
activeToken。新设备登录会把旧 Token 撤销,原因记录为new-device-login。 - Token 默认 90 天过期,这是登录安全期限,不是会员或套餐到期时间。
- 网页 Cookie 会话相互独立,不受单设备限制。
- 产品权限统一由
/api/qingpu/user-capabilities判断;签发或撤销设备令牌不会改变产品权限。
接口
POST /api/qingpu/login和POST /api/qingpu/register返回deviceToken元数据,以及只返回一次的rawToken。POST /api/qingpu/device-tokens/verify校验 Bearer Token。GET /api/qingpu/device-tokens和POST /api/qingpu/device-tokens/revoke需要网页 Cookie 会话,用于查看或撤销登录设备。
当另一个设备登录后,旧客户端在下一次鉴权请求时会收到 401 Unauthorized,并返回登录页。