查询单设备详情（V1 视图）#

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

用途与场景#

查询单台设备的详情视图，是设备列表页查询个人空间设备列表（V1 视图）的同构详情端点（同一响应 DTO、同一套 options 懒装配），面向新客户端：从列表点进单设备详情页时按需拉取，装配位按 options 精简请求。设备不存在时有具名错误出口 Device not found。

App 现役依据#

判定证据	内容
旧 app 文档收录记录	本端点属 /v1/retail 第二代，旧 app 文档仓未收录（当时文档缺失）；本仓旧 retail 手册页（git 历史 list.mdx）链接的 data-service OpenAPI 组覆盖同一资源族
两代分工语义	第一代无单设备详情端点（只有整表列表）；详情读取现役只有本端点
后端持续维护迹象	与 v1 列表同批引入（2025-06-20 引入系列），同受 DataAcquisitionDeviceControllerLegacyCompatibilityTest 契约测试覆盖

端点#

GET /main-service/main-api/v1/retail/device/data-acquisition-device/{dataAcquisitionDeviceId} — 查询单台设备的详情视图：v1 列表的同构详情端点（同一响应 DTO、同一套 options 懒装配），从列表点进详情按需拉取。

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

动线与完成判据#

status=200 且 data 为对象表示读取完成。查询结果为空集时服务端抛 Device not found（业务拒绝），因此「设备不存在」不会以空对象返回。

错误与边界#

error 原文	触发条件
Device not found	dataAcquisitionDeviceId 在当前租户无有效投影（不存在、已解绑/软删除或他人租户的 ID）

业务失败为业务拒绝族；认证失败为认证族（重新登录）；判定口径见错误响应差异。

调用关系与资源清理#

无客户端长连接资源需要释放。解绑、归属转移绑定后原 ID 失效（投影被软删除），再查报 Device not found；App 侧应把该错误当作「设备已不在个人空间」处理并回退到列表页。

已知缺口#

未执行真实联调：装配位缓存的有效期、在线状态刷新时序均无 App 实测佐证。App 侧应对全部装配位做空值兜底。