Qingpu 设备令牌

设备令牌用于轻铺AI 浏览器扩展和桌面端登录。因为这些客户端无法读取 APay 域名下的 HTTP-only Cookie,所以通过 Bearer Token 标识当前用户。设备令牌不代表订阅、试用、商品、订单、租户或产品权限。

合同

  • Token 使用 qpd_ 前缀,qingpu_device_tokens 只保存 SHA-256 哈希,不保存明文。
  • 每个用户最多一个 active Token。新设备登录会把旧 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,并返回登录页。