configuration 配置

配置模块(springdoc 分组 configuration)端点全量清单(88 端点 / 10 资源)。请求规范(鉴权、信封、分页控制字段)见接口规范;逐端点交互调试见 Swagger 视图

数据源:生产域 api-docs(2026-09-14 现场拉取,https://zxs.netbodycamera.com/main-service/v3/api-docs/)。

本页由脚本生成,不可手改,重跑生成器整体覆盖。

data-dictionary 数据字典

方法 路径 说明 详情
POST /main-service/system-api/configuration/data-dictionary/count count_5 Swagger
GET /main-service/system-api/configuration/data-dictionary/getById 按 ID 读取单条数据字典详情 Swagger
POST /main-service/system-api/configuration/data-dictionary/importList 把一批数据字典写入请求发布到 JMS 通道 data dictionary import list(租户随载荷传递) Swagger
POST /main-service/system-api/configuration/data-dictionary/list 按筛选条件读取数据字典列表(非分页,受 sqlQueryLimit 上限约束) Swagger
POST /main-service/system-api/configuration/data-dictionary/listCache 读取数据字典的"业务租户 + default 兜底"合并列表,供前端选择器整段加载 Swagger
POST /main-service/system-api/configuration/data-dictionary/page 按分页读取数据字典 Swagger
DELETE /main-service/system-api/configuration/data-dictionary/removeById 按 ID 逻辑删除一条数据字典(写 delete_time,不做物理删除) Swagger
DELETE /main-service/system-api/configuration/data-dictionary/removeByIds 按 ID 集合逻辑删除多条数据字典 Swagger
POST /main-service/system-api/configuration/data-dictionary/save 新增一条数据字典(同租户内按typeCode+code(精确匹配)做存在性检查) Swagger
PUT /main-service/system-api/configuration/data-dictionary/updateById 按 ID 修改数据字典(改写前按typeCode+code(精确匹配)做排除自身的重复检查) Swagger

data-dictionary-map 数据字典映射

方法 路径 说明 详情
POST /main-service/system-api/configuration/data-dictionary-map/count count_8 Swagger
GET /main-service/system-api/configuration/data-dictionary-map/getById 按 ID 读取单条数据字典映射详情 Swagger
POST /main-service/system-api/configuration/data-dictionary-map/importList importList_8 Swagger
POST /main-service/system-api/configuration/data-dictionary-map/list 按筛选条件读取数据字典映射列表(非分页,受 sqlQueryLimit 上限约束) Swagger
POST /main-service/system-api/configuration/data-dictionary-map/page 按分页读取数据字典映射 Swagger
DELETE /main-service/system-api/configuration/data-dictionary-map/removeById 按 ID 逻辑删除一条数据字典映射(写 delete_time,不做物理删除) Swagger
DELETE /main-service/system-api/configuration/data-dictionary-map/removeByIds 按 ID 集合逻辑删除多条数据字典映射 Swagger
POST /main-service/system-api/configuration/data-dictionary-map/save 新增一条数据字典映射(同租户内按typeCode+code+key(精确匹配)做存在性检查) Swagger
PUT /main-service/system-api/configuration/data-dictionary-map/updateById 按 ID 修改数据字典映射(改写前按typeCode+code+key(精确匹配)做排除自身的重复检查) Swagger

data-dictionary-table 数据字典表

方法 路径 说明 详情
POST /main-service/system-api/configuration/data-dictionary-table/count count_7 Swagger
GET /main-service/system-api/configuration/data-dictionary-table/getById 按 ID 读取单条数据字典表详情 Swagger
POST /main-service/system-api/configuration/data-dictionary-table/importList importList_7 Swagger
POST /main-service/system-api/configuration/data-dictionary-table/list 按筛选条件读取数据字典表列表(非分页,受 sqlQueryLimit 上限约束) Swagger
POST /main-service/system-api/configuration/data-dictionary-table/page 按分页读取数据字典表 Swagger
DELETE /main-service/system-api/configuration/data-dictionary-table/removeById 按 ID 逻辑删除一条数据字典表(写 delete_time,不做物理删除) Swagger
DELETE /main-service/system-api/configuration/data-dictionary-table/removeByIds 按 ID 集合逻辑删除多条数据字典表 Swagger
POST /main-service/system-api/configuration/data-dictionary-table/save 新增一条数据字典表(同租户内按typeCode+code+row+key(精确匹配)做存在性检查) Swagger
POST /main-service/system-api/configuration/data-dictionary-table/saveOrUpdate saveOrUpdate Swagger
PUT /main-service/system-api/configuration/data-dictionary-table/updateById 按 ID 修改数据字典表(改写前按typeCode+code+row+key(精确匹配)做排除自身的重复检查) Swagger

data-dictionary-type 数据字典类型

方法 路径 说明 详情
POST /main-service/system-api/configuration/data-dictionary-type/count count_6 Swagger
GET /main-service/system-api/configuration/data-dictionary-type/getById 按 ID 读取单条数据字典类型详情 Swagger
POST /main-service/system-api/configuration/data-dictionary-type/importList importList_6 Swagger
POST /main-service/system-api/configuration/data-dictionary-type/list 按筛选条件读取数据字典类型列表(非分页,受 sqlQueryLimit 上限约束) Swagger
POST /main-service/system-api/configuration/data-dictionary-type/listCache 读取数据字典类型的"业务租户 + default 兜底"合并列表,供前端选择器整段加载 Swagger
POST /main-service/system-api/configuration/data-dictionary-type/page 按分页读取数据字典类型 Swagger
DELETE /main-service/system-api/configuration/data-dictionary-type/removeById 按 ID 逻辑删除一条数据字典类型(写 delete_time,不做物理删除) Swagger
DELETE /main-service/system-api/configuration/data-dictionary-type/removeByIds 按 ID 集合逻辑删除多条数据字典类型 Swagger
POST /main-service/system-api/configuration/data-dictionary-type/save 新增一条数据字典类型(同租户内按typeCode(精确匹配)做存在性检查) Swagger
PUT /main-service/system-api/configuration/data-dictionary-type/updateById 按 ID 修改数据字典类型(改写前按typeCode(精确匹配)做排除自身的重复检查) Swagger

translation 翻译

方法 路径 说明 详情
POST /main-service/system-api/configuration/translation/count count_4 Swagger
GET /main-service/system-api/configuration/translation/getById translationId 读取单条翻译词条 Swagger
POST /main-service/system-api/configuration/translation/importList 从 XLSX 导入批量翻译词条 Swagger
POST /main-service/system-api/configuration/translation/list 按筛选条件读取翻译(i18n 词条)列表(非分页,受 sqlQueryLimit 上限约束) Swagger
POST /main-service/system-api/configuration/translation/page 按筛选条件分页读取翻译词条 Swagger
DELETE /main-service/system-api/configuration/translation/removeById translationId 删除一条翻译词条(逻辑删除) Swagger
DELETE /main-service/system-api/configuration/translation/removeByIds translationId 集合批量删除翻译词条(逻辑删除) Swagger
POST /main-service/system-api/configuration/translation/save 新增一条翻译词条 Swagger
POST /main-service/system-api/configuration/translation/saveMissing 匿名上报前端缺失的 i18n 词条(key→value 草稿),供运营侧在翻译管理中补充 Swagger
PUT /main-service/system-api/configuration/translation/updateById 修改一条翻译词条的语言/命名空间/键/值 Swagger

v1-general 通用接口(v1)

方法 路径 说明 详情
GET /main-service/main-api/v1/general/configuration/base/getClientIp getClientIp Swagger
GET /main-service/main-api/v1/general/configuration/base/getCloudServiceInfo 读取中心配置的云服务节点列表与推荐节点域名,供设备/采集服务器管理页的「云服务域名」下拉选择与新建表单默认值使用 Swagger

value-set 值集

方法 路径 说明 详情
POST /main-service/system-api/configuration/value-set/count count Swagger
GET /main-service/system-api/configuration/value-set/getById 按 ID 读取单条值集详情 Swagger
POST /main-service/system-api/configuration/value-set/importList importList Swagger
POST /main-service/system-api/configuration/value-set/list 按筛选条件读取值集列表(非分页,受 sqlQueryLimit 上限约束) Swagger
POST /main-service/system-api/configuration/value-set/page 按分页读取值集 Swagger
DELETE /main-service/system-api/configuration/value-set/removeById 按 ID 逻辑删除一条值集(写 delete_time,不做物理删除) Swagger
DELETE /main-service/system-api/configuration/value-set/removeByIds 按 ID 集合逻辑删除多条值集 Swagger
POST /main-service/system-api/configuration/value-set/save 新增一条值集(同租户内按typeCode+value(精确匹配)做存在性检查) Swagger
PUT /main-service/system-api/configuration/value-set/updateById 按 ID 修改值集(改写前按typeCode+value(精确匹配)做排除自身的重复检查) Swagger

value-set-map 值集映射

方法 路径 说明 详情
POST /main-service/system-api/configuration/value-set-map/count count_3 Swagger
GET /main-service/system-api/configuration/value-set-map/getById 按 ID 读取单条值集映射详情 Swagger
POST /main-service/system-api/configuration/value-set-map/importList importList_3 Swagger
POST /main-service/system-api/configuration/value-set-map/list 按筛选条件读取值集映射列表(非分页,受 sqlQueryLimit 上限约束) Swagger
POST /main-service/system-api/configuration/value-set-map/page 按分页读取值集映射 Swagger
DELETE /main-service/system-api/configuration/value-set-map/removeById 按 ID 逻辑删除一条值集映射(写 delete_time,不做物理删除) Swagger
DELETE /main-service/system-api/configuration/value-set-map/removeByIds 按 ID 集合逻辑删除多条值集映射 Swagger
POST /main-service/system-api/configuration/value-set-map/save 新增一条值集映射(同租户内按typeCode+key(精确匹配)做存在性检查) Swagger
PUT /main-service/system-api/configuration/value-set-map/updateById 按 ID 修改值集映射(改写前按typeCode+key(精确匹配)做排除自身的重复检查) Swagger

value-set-table 值集表

方法 路径 说明 详情
POST /main-service/system-api/configuration/value-set-table/count count_2 Swagger
GET /main-service/system-api/configuration/value-set-table/getById 按 ID 读取单条值集表详情 Swagger
POST /main-service/system-api/configuration/value-set-table/importList importList_2 Swagger
POST /main-service/system-api/configuration/value-set-table/list 按筛选条件读取值集表列表(非分页,受 sqlQueryLimit 上限约束) Swagger
POST /main-service/system-api/configuration/value-set-table/page 按分页读取值集表 Swagger
DELETE /main-service/system-api/configuration/value-set-table/removeById 按 ID 逻辑删除一条值集表(写 delete_time,不做物理删除) Swagger
DELETE /main-service/system-api/configuration/value-set-table/removeByIds 按 ID 集合逻辑删除多条值集表 Swagger
POST /main-service/system-api/configuration/value-set-table/save 新增一条值集表(同租户内按typeCode+row+key(精确匹配)做存在性检查) Swagger
POST /main-service/system-api/configuration/value-set-table/saveBatch saveBatch Swagger
PUT /main-service/system-api/configuration/value-set-table/updateById 按 ID 修改值集表(改写前按typeCode+row+key(精确匹配)做排除自身的重复检查) Swagger

value-set-type 值集类型

方法 路径 说明 详情
POST /main-service/system-api/configuration/value-set-type/count count_1 Swagger
GET /main-service/system-api/configuration/value-set-type/getById 按 ID 读取单条值集类型详情 Swagger
POST /main-service/system-api/configuration/value-set-type/importList importList_1 Swagger
POST /main-service/system-api/configuration/value-set-type/list 按筛选条件读取值集类型列表(非分页,受 sqlQueryLimit 上限约束) Swagger
POST /main-service/system-api/configuration/value-set-type/page 按分页读取值集类型 Swagger
DELETE /main-service/system-api/configuration/value-set-type/removeById 按 ID 逻辑删除一条值集类型(写 delete_time,不做物理删除) Swagger
DELETE /main-service/system-api/configuration/value-set-type/removeByIds 按 ID 集合逻辑删除多条值集类型 Swagger
POST /main-service/system-api/configuration/value-set-type/save 新增一条值集类型(同租户内按typeCode(精确匹配)做存在性检查) Swagger
PUT /main-service/system-api/configuration/value-set-type/updateById 按 ID 修改值集类型(改写前按typeCode(精确匹配)做排除自身的重复检查) Swagger