basedata 基础数据
基础数据模块（springdoc 分组 basedata）端点全量清单（119 端点 / 13 资源）。请求规范（鉴权、信封、分页控制字段）见接口规范；逐端点交互调试见 Swagger 视图。
数据源：生产域 api-docs（2026-09-14 现场拉取，https://zxs.netbodycamera.com/main-service/v3/api-docs/）。
本页由脚本生成，不可手改，重跑生成器整体覆盖。
employee 员工
| 方法 | 路径 | 说明 | 详情 |
|---|---|---|---|
| POST | /main-service/main-api/basedata/employee/count |
count_4 | Swagger |
| GET | /main-service/main-api/basedata/employee/getById |
按资源 ID 读取雇员详情 | Swagger |
| POST | /main-service/main-api/basedata/employee/importList |
importList | Swagger |
| POST | /main-service/main-api/basedata/employee/list |
按条件读取雇员列表 | Swagger |
| POST | /main-service/main-api/basedata/employee/page |
按页读取雇员列表 | Swagger |
| DELETE | /main-service/main-api/basedata/employee/removeById |
删除一个雇员 | Swagger |
| DELETE | /main-service/main-api/basedata/employee/removeByIds |
一次删除多个雇员 | Swagger |
| POST | /main-service/main-api/basedata/employee/save |
创建雇员 | Swagger |
| PUT | /main-service/main-api/basedata/employee/updateById |
更新雇员 | Swagger |
employee-attachment 员工附件
| 方法 | 路径 | 说明 | 详情 |
|---|---|---|---|
| POST | /main-service/main-api/basedata/employee-attachment/count |
count_11 | Swagger |
| GET | /main-service/main-api/basedata/employee-attachment/getById |
getById_12 | Swagger |
| POST | /main-service/main-api/basedata/employee-attachment/list |
list_12 | Swagger |
| POST | /main-service/main-api/basedata/employee-attachment/page |
page_12 | Swagger |
| DELETE | /main-service/main-api/basedata/employee-attachment/removeById |
removeById_12 | Swagger |
| DELETE | /main-service/main-api/basedata/employee-attachment/removeByIds |
removeByIds_12 | Swagger |
| POST | /main-service/main-api/basedata/employee-attachment/save |
save_12 | Swagger |
| PUT | /main-service/main-api/basedata/employee-attachment/updateById |
updateById_12 | Swagger |
employee-download-task 员工下载任务
| 方法 | 路径 | 说明 | 详情 |
|---|---|---|---|
| POST | /main-service/main-api/basedata/employee-download-task/count |
count_9 | Swagger |
| GET | /main-service/main-api/basedata/employee-download-task/getById |
getById_10 | Swagger |
| POST | /main-service/main-api/basedata/employee-download-task/list |
list_10 | Swagger |
| POST | /main-service/main-api/basedata/employee-download-task/page |
page_10 | Swagger |
| DELETE | /main-service/main-api/basedata/employee-download-task/removeById |
removeById_10 | Swagger |
| DELETE | /main-service/main-api/basedata/employee-download-task/removeByIds |
removeByIds_10 | Swagger |
| POST | /main-service/main-api/basedata/employee-download-task/save |
save_10 | Swagger |
| PUT | /main-service/main-api/basedata/employee-download-task/updateById |
updateById_10 | Swagger |
employee-download-task-file-index 员工下载任务文件索引
| 方法 | 路径 | 说明 | 详情 |
|---|---|---|---|
| POST | /main-service/main-api/basedata/employee-download-task-file-index/count |
count_10 | Swagger |
| GET | /main-service/main-api/basedata/employee-download-task-file-index/getById |
getById_11 | Swagger |
| POST | /main-service/main-api/basedata/employee-download-task-file-index/list |
list_11 | Swagger |
| POST | /main-service/main-api/basedata/employee-download-task-file-index/page |
page_11 | Swagger |
| DELETE | /main-service/main-api/basedata/employee-download-task-file-index/removeById |
removeById_11 | Swagger |
| DELETE | /main-service/main-api/basedata/employee-download-task-file-index/removeByIds |
removeByIds_11 | Swagger |
| POST | /main-service/main-api/basedata/employee-download-task-file-index/save |
save_11 | Swagger |
| PUT | /main-service/main-api/basedata/employee-download-task-file-index/updateById |
updateById_11 | Swagger |
employee-fingerprint 员工指纹
| 方法 | 路径 | 说明 | 详情 |
|---|---|---|---|
| POST | /main-service/main-api/basedata/employee-fingerprint/count |
count_8 | Swagger |
| GET | /main-service/main-api/basedata/employee-fingerprint/getById |
getById_9 | Swagger |
| POST | /main-service/main-api/basedata/employee-fingerprint/list |
list_9 | Swagger |
| POST | /main-service/main-api/basedata/employee-fingerprint/page |
page_9 | Swagger |
| DELETE | /main-service/main-api/basedata/employee-fingerprint/removeById |
removeById_9 | Swagger |
| DELETE | /main-service/main-api/basedata/employee-fingerprint/removeByIds |
removeByIds_9 | Swagger |
| POST | /main-service/main-api/basedata/employee-fingerprint/save |
save_9 | Swagger |
| PUT | /main-service/main-api/basedata/employee-fingerprint/updateById |
updateById_9 | Swagger |
employee-nfc-card 员工 NFC 卡
| 方法 | 路径 | 说明 | 详情 |
|---|---|---|---|
| POST | /main-service/main-api/basedata/employee-nfc-card/count |
count_7 | Swagger |
| GET | /main-service/main-api/basedata/employee-nfc-card/getById |
getById_8 | Swagger |
| POST | /main-service/main-api/basedata/employee-nfc-card/list |
list_8 | Swagger |
| POST | /main-service/main-api/basedata/employee-nfc-card/page |
page_8 | Swagger |
| DELETE | /main-service/main-api/basedata/employee-nfc-card/removeById |
removeById_8 | Swagger |
| DELETE | /main-service/main-api/basedata/employee-nfc-card/removeByIds |
removeByIds_8 | Swagger |
| POST | /main-service/main-api/basedata/employee-nfc-card/save |
save_8 | Swagger |
| PUT | /main-service/main-api/basedata/employee-nfc-card/updateById |
updateById_8 | Swagger |
employee-talk-group 员工对讲组
| 方法 | 路径 | 说明 | 详情 |
|---|---|---|---|
| POST | /main-service/main-api/basedata/employee-talk-group/count |
count_6 | Swagger |
| GET | /main-service/main-api/basedata/employee-talk-group/getById |
getById_7 | Swagger |
| POST | /main-service/main-api/basedata/employee-talk-group/list |
list_7 | Swagger |
| POST | /main-service/main-api/basedata/employee-talk-group/page |
page_7 | Swagger |
| DELETE | /main-service/main-api/basedata/employee-talk-group/removeById |
removeById_7 | Swagger |
| DELETE | /main-service/main-api/basedata/employee-talk-group/removeByIds |
removeByIds_7 | Swagger |
| POST | /main-service/main-api/basedata/employee-talk-group/save |
save_7 | Swagger |
| PUT | /main-service/main-api/basedata/employee-talk-group/updateById |
updateById_7 | Swagger |
employee-user 员工用户关联
| 方法 | 路径 | 说明 | 详情 |
|---|---|---|---|
| POST | /main-service/main-api/basedata/employee-user/count |
count_5 | Swagger |
| GET | /main-service/main-api/basedata/employee-user/getById |
按资源 ID 读取雇员—用户关联详情 | Swagger |
| POST | /main-service/main-api/basedata/employee-user/list |
按条件读取雇员—用户关联列表 | Swagger |
| POST | /main-service/main-api/basedata/employee-user/page |
按页读取雇员—用户关联列表 | Swagger |
| DELETE | /main-service/main-api/basedata/employee-user/removeById |
删除一个雇员—用户关联 | Swagger |
| DELETE | /main-service/main-api/basedata/employee-user/removeByIds |
一次删除多个雇员—用户关联 | Swagger |
| POST | /main-service/main-api/basedata/employee-user/save |
创建雇员—用户关联 | Swagger |
| PUT | /main-service/main-api/basedata/employee-user/updateById |
更新雇员—用户关联 | Swagger |
file-index 文件索引
| 方法 | 路径 | 说明 | 详情 |
|---|---|---|---|
| POST | /main-service/main-api/basedata/file-index/count |
count_2 | Swagger |
| GET | /main-service/main-api/basedata/file-index/getById |
getById_3 | Swagger |
| POST | /main-service/main-api/basedata/file-index/list |
list_3 | Swagger |
| POST | /main-service/main-api/basedata/file-index/page |
page_3 | Swagger |
| DELETE | /main-service/main-api/basedata/file-index/removeById |
removeById_3 | Swagger |
| DELETE | /main-service/main-api/basedata/file-index/removeByIds |
removeByIds_3 | Swagger |
| POST | /main-service/main-api/basedata/file-index/save |
save_3 | Swagger |
| PUT | /main-service/main-api/basedata/file-index/updateById |
updateById_3 | Swagger |
file-index-thumbnail 文件索引缩略图
| 方法 | 路径 | 说明 | 详情 |
|---|---|---|---|
| POST | /main-service/main-api/basedata/file-index-thumbnail/count |
count_3 | Swagger |
| GET | /main-service/main-api/basedata/file-index-thumbnail/getById |
getById_4 | Swagger |
| POST | /main-service/main-api/basedata/file-index-thumbnail/list |
list_4 | Swagger |
| POST | /main-service/main-api/basedata/file-index-thumbnail/page |
page_4 | Swagger |
| DELETE | /main-service/main-api/basedata/file-index-thumbnail/removeById |
removeById_4 | Swagger |
| DELETE | /main-service/main-api/basedata/file-index-thumbnail/removeByIds |
removeByIds_4 | Swagger |
| POST | /main-service/main-api/basedata/file-index-thumbnail/save |
save_4 | Swagger |
| PUT | /main-service/main-api/basedata/file-index-thumbnail/updateById |
updateById_4 | Swagger |
storage-policy 存储策略
| 方法 | 路径 | 说明 | 详情 |
|---|---|---|---|
| POST | /main-service/main-api/basedata/storage-policy/count |
count_1 | Swagger |
| GET | /main-service/main-api/basedata/storage-policy/getById |
getById_2 | Swagger |
| POST | /main-service/main-api/basedata/storage-policy/list |
list_2 | Swagger |
| POST | /main-service/main-api/basedata/storage-policy/page |
page_2 | Swagger |
| DELETE | /main-service/main-api/basedata/storage-policy/removeById |
removeById_2 | Swagger |
| DELETE | /main-service/main-api/basedata/storage-policy/removeByIds |
removeByIds_2 | Swagger |
| POST | /main-service/main-api/basedata/storage-policy/save |
save_2 | Swagger |
| PUT | /main-service/main-api/basedata/storage-policy/updateById |
updateById_2 | Swagger |
talk-group 对讲组
| 方法 | 路径 | 说明 | 详情 |
|---|---|---|---|
| POST | /main-service/main-api/basedata/talk-group/destroyRoom |
destroyRoom | Swagger |
| POST | /main-service/main-api/basedata/talk-group/ensureAllRooms |
ensureAllRooms | Swagger |
| POST | /main-service/main-api/basedata/talk-group/ensureRoom |
触发中心为指定群组确保 AudioBridge 房间存在 | Swagger |
| GET | /main-service/main-api/basedata/talk-group/getById |
getById | Swagger |
| POST | /main-service/main-api/basedata/talk-group/list |
list | Swagger |
| POST | /main-service/main-api/basedata/talk-group/listCache |
listCache | Swagger |
| POST | /main-service/main-api/basedata/talk-group/page |
page | Swagger |
| POST | /main-service/main-api/basedata/talk-group/pushPttConfig |
让中心按当前群组绑定关系为指定设备重新生成 PTT 配置并投递到设备（device/{deviceNo}/ptt/deliver/v1） |
Swagger |
| DELETE | /main-service/main-api/basedata/talk-group/removeById |
removeById | Swagger |
| DELETE | /main-service/main-api/basedata/talk-group/removeByIds |
按群组 ID 批量删除对讲群组，并级联删除其成员绑定关系 | Swagger |
| POST | /main-service/main-api/basedata/talk-group/save |
save | Swagger |
| POST | /main-service/main-api/basedata/talk-group/saveWithDataAcquisitionDevices |
创建一个对讲群组，并在同一事务内写入群组与记录仪（数据采集设备）的初始绑定关系 | Swagger |
| PUT | /main-service/main-api/basedata/talk-group/updateById |
updateById | Swagger |
| PUT | /main-service/main-api/basedata/talk-group/updateByIdWithDataAcquisitionDevices |
修改既有群组的基础字段（名称、简介、组织）并按 SAVE/UPDATE/REMOVE 变更集同步成员绑定 |
Swagger |
talk-group-data-acquisition-device 对讲组与采集设备关联
| 方法 | 路径 | 说明 | 详情 |
|---|---|---|---|
| POST | /main-service/main-api/basedata/talk-group-data-acquisition-device/count |
count | Swagger |
| GET | /main-service/main-api/basedata/talk-group-data-acquisition-device/getByDataAcquisitionDeviceId |
按记录仪（数据采集设备）ID 读取该设备的详情、PTT 在线状态及其全部群组绑定（含每个群组的音频参数与房间配置标志） | Swagger |
| GET | /main-service/main-api/basedata/talk-group-data-acquisition-device/getById |
getById_1 | Swagger |
| GET | /main-service/main-api/basedata/talk-group-data-acquisition-device/getByTalkGroupId |
getByTalkGroupId | Swagger |
| POST | /main-service/main-api/basedata/talk-group-data-acquisition-device/list |
list_1 | Swagger |
| POST | /main-service/main-api/basedata/talk-group-data-acquisition-device/listForDevice |
listForDevice | Swagger |
| POST | /main-service/main-api/basedata/talk-group-data-acquisition-device/listForTalkGroup |
listForTalkGroup | Swagger |
| POST | /main-service/main-api/basedata/talk-group-data-acquisition-device/page |
page_1 | Swagger |
| POST | /main-service/main-api/basedata/talk-group-data-acquisition-device/pageForDevice |
pageForDevice | Swagger |
| POST | /main-service/main-api/basedata/talk-group-data-acquisition-device/pageForTalkGroup |
按群组维度分页读取群组及其成员（记录仪）列表，同时返回 SFU/设备 PTT 在线状态快照 | Swagger |
| DELETE | /main-service/main-api/basedata/talk-group-data-acquisition-device/removeById |
removeById_1 | Swagger |
| DELETE | /main-service/main-api/basedata/talk-group-data-acquisition-device/removeByIds |
removeByIds_1 | Swagger |
| POST | /main-service/main-api/basedata/talk-group-data-acquisition-device/save |
save_1 | Swagger |
| POST | /main-service/main-api/basedata/talk-group-data-acquisition-device/saveBatch |
saveBatch | Swagger |
| PUT | /main-service/main-api/basedata/talk-group-data-acquisition-device/updateByDataAcquisitionDeviceIdWithTalkGroups |
以单台记录仪为主体，按 SAVE/UPDATE/REMOVE 变更集原子地更新它与各对讲群组的绑定关系（含讲话权限） |
Swagger |
| PUT | /main-service/main-api/basedata/talk-group-data-acquisition-device/updateById |
updateById_1 | Swagger |
目录