配置（业务）#

配置模块讲一件事：把中心侧的数据字典族开放给采集侧（采集服务器 / 采集设备）——字典与字典类型的缓存读取（listCache 族）加上令牌盐值的写入（saveOrUpdateTokenSalt 族），共 6 端点。字典的管理面正本（CRUD、异步导入、租户+default 合并缓存）在 data-service 的配置（业务），本模块是它的服务间投影。

本页是 device-service configuration 模块接口的业务说明，非业务说明不在本页复述：

• OpenAPI JSON（可直接导入 Postman 等工具）：https://zxs.netbodycamera.com/device-service/v3/api-docs/configuration
• 在线 Swagger 视图：device-service · 配置
• 端点全量清单（含中文说明）：清单层 · configuration

参数、请求/响应字段、错误码等契约事实一律见上述 Swagger 与清单层；本页只讲业务语义与动线。

data-dictionary 数据字典#

listCacheByDataAcquisitionDeviceNo / listCacheByDataAcquisitionServerNo：按采集设备编号 / 采集服务器编号读取数据字典缓存列表——采集侧拉平本地字典视图的只读通道（设备/服务器各一枚同构端点，本模块各资源的成对端点均为这两种身份口径）。字典条目的管理端语义（新增/导入/租户合并）见 data-service 数据字典。契约见清单层 · data-dictionary。

data-dictionary-map 数据字典映射#

saveOrUpdateTokenSaltByDataAcquisitionDeviceNo / saveOrUpdateTokenSaltByDataAcquisitionServerNo：按编号保存或更新令牌盐值——本模块唯一的写端点对，与 device 组的认证令牌密钥生成端点同属「采集侧 ↔ 中心」的服务间信任面（盐值落库、密钥经 device 组端点生成并进 7 天令牌缓存；两者的组合算法属源码细节，本页只并列点名）。管理端的数据字典映射 CRUD 见 data-service 数据字典映射。契约见清单层 · data-dictionary-map。

data-dictionary-type 数据字典类型#

listCacheByDataAcquisitionDeviceNo / listCacheByDataAcquisitionServerNo：按编号读取数据字典类型缓存列表，与 data-dictionary 同款只读投影（类型树是字典条目的分组维度）。管理端正本见 data-service 数据字典类型。契约见清单层 · data-dictionary-type。

runtime-links 运行时关联#

本模块无专属定时任务与消费者（全量表见 device-service 消费者与 data-service 定时任务、缓存的 device-service 节）；令牌信任链的消费侧（dataAcquisitionDeviceTokenCache / dataAcquisitionServerTokenCache，各 7 天）见设备（业务）的运行时关联。