快照(业务)

快照模块是八张当前值表:资源族与 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 与清单层;本页只讲业务语义与动线。

data-acquisition-box-usage-snap 采集箱使用快照

采集箱使用状态当前值(配对轨迹表见 history);契约见清单层

data-acquisition-device-claim-snap 采集设备领用快照

采集设备领用状态当前值;契约见清单层

data-acquisition-device-give-back-snap 采集设备归还快照

采集设备归还状态当前值;契约见清单层

data-sync-snap 数据同步快照

数据同步状态当前值(同步调度见 history(业务)· 运行时关联);契约见清单层

device-position-snap 设备位置快照

设备当前位置值;契约见清单层

device-state-snap 设备状态快照

设备当前状态值;契约见清单层

fingerprint-scanner-usage-snap 指纹扫描仪使用快照

指纹扫描仪使用状态当前值;契约见清单层

nfc-card-usage-snap NFC 卡使用快照

NFC 卡使用状态当前值;契约见清单层

本模块在 runtime 全量表(定时任务/缓存/消费者)中无专属条目;各 snap 表的写入方未逐表核验,以源码为准(数据同步族的运行时对应见 history(业务))。