查询个人空间设备列表#

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

用途与场景#

查询当前用户个人空间内的设备列表，是 App 设备列表页的第一代读取端点。返回两类来源的设备投影：自己绑定的设备（state=bind 的设备直接拥有投影）与他人分享来的设备（state=To be confirm share / confirm share 的设备分享投影）。每台设备附加当前采集服务器绑定、三路连接状态；分享来的设备还带设备管理标记。

设备租户投影三态与来源语义见账号与个人空间。

App 现役依据#

判定证据	内容
旧 app 文档收录记录	旧 app 文档仓在 docs/api/main-api/device/data-acquisition-device/listForPersonalSpace/ 收录本端点，属 App 既有调用面
两代分工语义	两代列表共享同一 service 方法 listForRetail；写路径（绑定/解绑/分享生命周期）只存在于第一代，App 必须调用本代端点完成写后用读取端点刷新列表
后端持续维护迹象	第一代代码 2026-09 仍有维护提交（免 read 校验注释、权限条件收敛），后端契约测试持续钉住其行为

端点#

GET /main-service/main-api/device/data-acquisition-device/listForPersonalSpace — 查询当前用户个人空间内的设备列表，是 App 设备列表页的第一代读取端点。

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

动线与完成判据#

status=200 且 data 为数组表示读取完成；data=[] 是成功空集（例如按 state 过滤无匹配）。

错误与边界#

本端点为纯读取，无业务拒绝分支；失败出口只有认证族（重新登录）与协议/服务器错误族，判定口径见错误响应差异。state 传无效取值不报错、返回空数组。

调用关系与资源清理#

无客户端长连接资源需要释放。绑定、解绑与分享生命周期动作会改变本列表内容；App 在写操作成功后应重新拉取本列表刷新界面。

已知缺口#

未执行真实联调：在线状态缓存的刷新时序、分享退场后本列表的可见延迟均无 App 实测佐证。App 侧应对 dataAcquisitionServer、deviceManage 等可空字段做空值兜底。