快照模块是八张当前值表:资源族与 history(业务) 的轨迹表同名配对(hist 记时间线、snap 存当前值;比 history 少「归还文件索引」与「同步审计」两类)。与 history 同样是「服务内部写入、集成面查询」的形态,REST CRUD 仅为查询/管理暴露。
本页是 data-service
snapshot模块接口的业务说明,非业务说明不在本页复述:
- OpenAPI JSON(可直接导入 Postman 等工具):
https://zxs.netbodycamera.com/main-service/v3/api-docs/snapshot- 在线 Swagger 视图:data-service · 快照
- 端点全量清单(含权限点与中文说明):清单层 · snapshot
参数、请求/响应字段、错误码等契约事实一律见上述 Swagger 与清单层;本页只讲业务语义与动线。
采集箱使用状态当前值(配对轨迹表见 history);契约见清单层。
采集设备领用状态当前值;契约见清单层。
采集设备归还状态当前值;契约见清单层。
数据同步状态当前值(同步调度见 history(业务)· 运行时关联);契约见清单层。
设备当前位置值;契约见清单层。
设备当前状态值;契约见清单层。
指纹扫描仪使用状态当前值;契约见清单层。
NFC 卡使用状态当前值;契约见清单层。
本模块在 runtime 全量表(定时任务/缓存/消费者)中无专属条目;各 snap 表的写入方未逐表核验,以源码为准(数据同步族的运行时对应见 history(业务))。