ES Documentation
手册
API
手册
API
简体中文

名下设备与绑定清单同步

验证状态：本页为接入视角新写（19 号票）。事实取材自已核验场景页与清单层生成页（provenance 见各链接目标），本页自身不做二次核验、未联调。

用途与场景

采集服务器启动/同步时回答两个问题：「我名下有哪些采集设备、绑定处于什么周期」与「设备的实际信息如何回流中心」。这是接入动线的第二步：先有身份（接入身份与服务间认证），再拉清单。

动线

  1. 拉绑定生命周期列表：POST /device-service/main-api/device/data-acquisition-device/listByDataAcquisitionServerNo —— 按采集服务器编号查询其关联采集设备的绑定生命周期列表（服务侧只读视角）。契约见清单层 · data-acquisition-device与设备业务 · binding-lifecycle。
  2. 装配单设备主档：GET /device-service/main-api/device/data-acquisition-device/getByDataAcquisitionDeviceNo —— 按采集设备编号查询设备信息（双链接同上资源锚点）。
  3. 设备实际信息回流：POST /device-service/main-api/device/data-acquisition-device/pushInfoByDataAcquisitionDeviceNo —— 按编号推送采集设备信息：设备实际信息以推送时点为准，中心侧以此校正档案（见设备业务 · identity-and-token节内 pushInfo 条目）。
  4. 理解绑定的来源（不在本侧）：绑定关系由管理侧维护——data-service 的采集服务器—采集设备关联表（CRUD，机构管理台操作），本动线第 1 步的端点只是只读消费这个绑定。管理侧契约见下表。

端点

端点（导航级） 用途 契约
POST /device-service/main-api/device/data-acquisition-device/listByDataAcquisitionServerNo 按采集服务器编号查询其关联采集设备的绑定生命周期列表（只读） 清单层 · 业务
GET /device-service/main-api/device/data-acquisition-device/getByDataAcquisitionDeviceNo 按采集设备编号查询采集设备信息 同资源锚点
POST /device-service/main-api/device/data-acquisition-device/pushInfoByDataAcquisitionDeviceNo 按编号推送采集设备信息（信息回流） 同资源锚点
POST /main-service/main-api/device/data-acquisition-server-data-acquisition-device/list （管理侧）查询采集服务器—采集设备绑定列表 清单层 · 业务
POST /main-service/main-api/device/data-acquisition-server/listCache （管理侧台账）缓存读取采集服务器列表，组合在线状态与绑定设备数等动态值 清单层 · 业务

管理侧两行不是采集服务器的调用面，列在这里是为了让接入开发者知道绑定与台账数据的来源与维护方：设备详情里「绑定服务器」组合项即来自该关联表（见设备业务）；台账域全景见机构手册设备与资产域总览。

行为规则（一句话点名）

  • 绑定清单没有面向采集服务器的推送通知：中心的设备变更通知只发相关用户 App，不是采集服务器（消费者全表见MQTT 消费者）——绑定变更后的再同步时机由采集服务器自行调度（重启拉取或轮询，平台无约定）。
  • 管理侧台账的异步导入 importList 与缓存读取 listCache 语义（data=true 只表示已提交、读取组合动态值）不复述，见设备业务 · data-acquisition-server与设备与资产域总览。

已知缺口

  1. 「绑定生命周期」的字段枚举与周期语义（周期取值、状态机）在清单层无字段级展开——服务间接口以 Swagger 为准，但生命周期语义需后端确认。
  2. 绑定变更的再同步无平台约定（见行为规则第 1 条），采集服务器侧的最优同步策略缺证。
目录