按设备与类型列出设备文件#

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

用途与场景#

列出中心服务器文件存储区中某台设备某类文件（如 image/video）的文件清单。当前 Web「设备文件备份」页选择设备号与类型后调用本操作加载列表；配合「上传指令」（正本在票 11 retrieve-items.md）与文件下载完成备份闭环。

使用位置#

页面/功能	角色或空间分支
设备文件备份页加载列表	机构/管理员页面；deviceNo 与 type 均非空才触发（300ms 节流）

端点#

GET /main-service/main-api/v1/general/device/data-acquisition-device/listFilesByDeviceNoAndType — 列出中心服务器文件存储区中某台设备某类文件（如 image/video）的文件清单。

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

动线与完成判据#

status=200 且 data 数组可消费即读取结束；[] 表示目录不存在或为空（成功空态，非错误）。读取直查文件系统，无缓存窗口。

错误与边界#

认证失败/业务拒绝（Illegal path segment）。读取无副作用，可重试。

调用关系与资源清理#

无长连接资源。path 供下载设备文件使用；「上传指令」让设备把文件推送到该目录（其正本在票 11 operations/device-remote-control/retrieve-items.md，本页不重复）。

已知缺口#

url 键的 domain-url 在部署中为外部域名（es-center-server.domain-url，Controller :67-70），示例中的主机名为占位；设备号与类型的权威取值范围（存储区现有目录）无独立枚举接口，Web 用自由输入 + 列表反推。