查询设备分享记录列表#

验证状态：已源码核验、未联调（无 app 调用图）；services 基线：源码归纳 @ 2026-09-14

用途与场景#

查询当前租户发出的设备分享记录，是 App「分享管理」页的数据源：每条记录带完整时间线（邀请 / 确认 / 解除 / 撤销时间）与状态，可用于渲染「我分享给了谁、是否已确认」。记录 ID（deviceShareId）是撤销设备分享与修改设备分享管理标记的定位键。

注意视角：分享记录驻留在发起方租户——本端点返回的是当前用户作为发起方发出的分享；收到的分享（受赠方视角）不经本端点，而是通过设备列表中 state=To be confirm share / confirm share 的分享投影感知（查询个人空间设备列表、V1 设备列表 的 deviceShareList 装配）。

App 现役依据#

判定证据	内容
旧 app 文档收录记录	旧 app 文档仓在 docs/api/main-api/device/device-share/listForPersonalSpace/ 收录本端点，属 App 既有调用面
两代分工语义	/v1/retail 第二代无独立的个人空间分享记录列表端点（v1 设备列表的 deviceShareList 是设备维度装配，带联系人视图，非记录管理视角）；分享管理页现役只有本端点
后端持续维护迹象	sqlQueryLimit 归一化行为由 DeviceShareControllerListForPersonalSpaceTest 参数化测试钉住（0→1、100001→100000、缺省 100）

端点#

POST /main-service/main-api/device/device-share/listForPersonalSpace — 查询当前租户发出的设备分享记录。

端点全量事实（参数、请求/响应字段、错误码、权限点）见清单层 device · device-share 设备分享；业务语义（wire 惯例、限频、租户声明等）见设备业务 · device-share 设备分享。

动线与完成判据#

status=200 且 data 为数组表示读取完成；data=[] 是成功空集（当前租户未发出过分享）。分享生命周期动作（发起/确认/撤销/解除/改标记）后应重新拉取本列表刷新分享管理页。

错误与边界#

本端点为纯读取，无业务拒绝分支；失败出口只有认证族（重新登录）与协议/服务器错误族，判定口径见错误响应差异。sqlQueryLimit 传 0、负数或超大值不报错，被钳制后照常返回。

边界：时间线四字段中，liftTime / cancelTime 标志的终态行在本列表不可见——分享管理页如需展示历史分享，只能依赖客户端留存或另行追溯；本端点合同仅覆盖活跃分享。

调用关系与资源清理#

无客户端长连接资源需要释放。本列表的 deviceShareId 驱动撤销与改管理标记；列表内容随分享生命周期动作变化，写操作后应刷新。

已知缺口#

未执行真实联调：默认 100 条上限在分享数较多场景下的翻页体验（本端点无分页参数，只能放大 sqlQueryLimit）无 App 实测佐证；targetPortraitUrl 等联系人头像字段不在本端点契约内（v1 设备列表的 deviceShareList 装配才有）。