IoT 设备接入总览
晓葆开放平台提供两种 IoT 设备接入规范：面向家用场景的蓝牙设备接入（检测插件 SDK）， 以及面向健康站现场部署的健康站设备接入（扫码启动 S2S 接口）。 厂家按部署场景选择对应规范完成对接。
两种接入场景
| 蓝牙设备接入 | 健康站设备接入 | |
|---|---|---|
| 部署场景 | 用户家中，BLE 配对使用 | 健康站现场，固定设备固定点位 |
| 用户交互 | 小程序内蓝牙直连，实时出数 | 用户扫设备二维码授权，设备轮询拿用户信息后开始检测 |
| 接入方式 | 检测插件 SDK（Pattern A / B） | S2S REST API（AppKey + HMAC-SHA256 签名） |
| 开发语言 | JavaScript（微信小程序插件） | 任意语言，实现 HTTP API 调用即可 |
| 典型能力 | 血压、血糖、血氧、体脂、心电等居家检测 | 肺功能、多参数监测等健康站专业检测 |
通用原则
凭证安全
无论哪种接入模式，appSecret 及厂商算法密钥只允许存在于晓葆服务端或供应商受控适配组件， 不得写入微信小程序插件代码或设备固件明文配置。 插件只上传原始采集数据，不直连厂商云。
device_key 唯一性
每款硬件型号对应唯一的 device_key，由平台分配并审核发布后才允许正式上报。 运行时报告中使用的 device_key 必须等于平台已发布的值，否则上报会被拒绝。
幂等上报
所有上报接口使用 report_no（健康站扫码）或 client_request_id（S2S 上报） 保证幂等——同一 ID 重复上报返回成功，不重复计次，网络重试安全。