总览#

数据服务（main-service）HTTP 端点全量清单：按 springdoc 分组一模块一页，组内按资源（Controller 路径段）分节。请求规范见接口规范；逐端点交互调试见 Swagger 视图。

数据源：生产域 api-docs（2026-09-14 现场拉取，https://zxs.netbodycamera.com/main-service/v3/api-docs/）。

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

模块	端点数	资源数	备注
device 设备	235	29	含 17 个分组外端点
basedata 基础数据	119	13
message 消息	112	14
order 订单	24	3
history 历史	80	10
snapshot 快照	64	8
user-center 用户中心	107	9
authority 授权	75	9
configuration 配置	88	10
合计	904	—	分组外另有 17 个（device 设备）

drift-report 漂移比对摘要#

• 源码（@RestController 类级 + 方法级 @RequestMapping 拼接）：921 端点（126 个 Controller，另有 2 个非 @RestController 通配代理类不计）。
• 线上（生产域 api-docs 9 组并集）：904 端点，无任何源码不存在的端点。
• 差异 17 个，全部为分组外端点（/api/dashboard/** 16 + /main-api/v1/public/firmware/latest 1），已收录进 device 设备 的「分组外端点」小节。
• 端点中文说明表覆盖率：237/904，缺失回退 operationId。