查询单台记录仪的群组绑定（getByDataAcquisitionDeviceId）#

验证状态：已源码核验、未联调；适用基线：源码归纳 @ 2026-09-14

用途与场景#

按记录仪（数据采集设备）ID 读取该设备的详情、PTT 在线状态及其全部群组绑定（含每个群组的音频参数与房间配置标志）。本页是 http-get-main-service-main-api-basedata-talk-group-data-acquisition-device-getbydataacquisitiondeviceid-d7ceb9ec 的唯一操作正本。

使用位置#

页面/功能	角色或空间分支
打开设备面板时加载设备详情与绑定	需要 talk-group-data-acquisition-device:read 或 administrator

端点#

GET /main-service/main-api/basedata/talk-group-data-acquisition-device/getByDataAcquisitionDeviceId — 按记录仪（数据采集设备）ID 读取该设备的详情、PTT 在线状态及其全部群组绑定（含每个群组的音频参数与房间配置标志）。

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

动线与完成判据#

status=200 即查询完成；data=null 与 data.talkGroups=[] 语义不同——前者是设备不存在或无数据权限，后者是设备存在但未绑定群组（Web 以 assertNoSoftFail + null 检查区分）。

错误与边界#

• 认证/权限失败适用认证失败与权限失败；参数缺失适用请求校验。
• 在线状态为查询时刻快照；false 不区分离线与未知。
• 数据权限会过滤结果集：跨租户查询返回 data=null 而非 403。

调用关系与资源清理#

• 前序：设备列表分页（工作台设备面板）。
• 后续：编辑绑定使用 updateByDataAcquisitionDeviceIdWithTalkGroups 正本。

已知缺口#

1. 未执行真实 HTTP/数据库联调；talkGroups 子查询 SQL 的排序与模糊语义未逐字段核验。
2. 本查询入口的 dataAcquisitionDeviceId 无 @Size 约束（仅 NotBlank），超长值的行为由 SQL 决定，未核验。