YD/T 4872-2024 标准解读

一、标准适用场景与实施阶段

• 业务类型：适用于基于NB-IoT的供热室温采集器与应用平台之间的接口设计、开发、联调、上线及运维验收，覆盖室温数据上报、设备注册、心跳、告警推送、参数查询与设置、指令下发、日志及对账接口。
• 实施环节：包含接口需求确认、接口文档冻结、测试环境联调、预生产环境验证、现场安装接入、数据比对、试运行与竣工验收。
• 验收阶段：按接口功能验收、数据质量验收、安全与稳定性验收、试运行验收四阶段执行；未完成前一阶段整改闭环，不得进入下一阶段。

二、现场实操合规规范

• 接口协议与编码：平台接口应采用HTTPS，数据封装采用JSON，字符编码为UTF-8；报文应包含消息标识、设备标识、时间戳、数据体、签名或鉴权字段。
• 鉴权与时钟：设备或采集器接入应完成鉴权，令牌、密钥不得硬编码于前端页面或明文写入日志；对时后平台与采集器时间偏差应≤5s，报文时间戳格式应统一。
• 采集与上报参数：室温采集数据应至少包含采集点编号、采集时间、温度值、单位、电量或供电状态、信号强度；上报周期按供热运行方案配置，常规周期宜为30min或60min，告警触发后应支持即时补报。
• 阈值与重试：室温数据有效范围宜为0℃～50℃，超出范围应标记异常；接口调用失败应自动重试，重试次数不少于3次，重试间隔宜采用递增策略，连续失败应生成告警。
• 安装与信号核验：现场安装后应核验NB-IoT接入状态，RSRP宜≥-110dBm，SNR宜≥-10dB；信号不满足时应调整安装位置、天线或上报策略，不得以人工录入替代自动上报。
• 指令与参数设置：平台下发查询、重启、周期调整等指令应有指令流水、执行结果回执与超时处理；指令超时时间应可配置，默认不宜大于60s。
• 现场质量管控：每个采集点应形成安装位置、设备编号、平台测点、接口标识映射表；接口变更应履行审批，禁止未经测试直接修改生产接口。

三、成果验收核验标准

1. 分项核验：按接口逐项执行用例，记录请求报文、响应报文、时间戳、异常码与复测结果；关键接口应留存抓包或日志证据。
2. 数据比对：选取不同楼层、朝向、热用户类型进行人工测温比对，采集器上报值与现场实测值偏差超过允许范围时，应判定为不合格项并整改。
3. 整体验收：分项核验全部合格且试运行期间无未闭环重大缺陷后，由建设、运维、平台提供方共同签署验收记录。

四、实操常见问题与质控方案

• 报文不一致：字段命名、时间格式、单位与接口文档不一致。质控方案：接口文档冻结后纳入配置管理，联调前进行结构校验，变更须经评审并同步更新文档。
• 数据缺失或重复：弱信号、平台重复接收、采集器时钟漂移导致缺报、迟报或重复报。质控方案：设置缺报告警、去重规则与时标校验，弱信号点位进行安装位置整改或调整上报窗口。
• 异常值未标识：温度超限、传感器故障、离线值未按异常处理。质控方案：平台对越限、空值、非数值、长期不变值建立异常标记规则，并输出异常清单供复核。
• 接口安全缺陷：证书过期、密钥泄露、未鉴权即可访问。质控方案：上线前开展安全测试，启用证书有效期监控、最小权限访问和日志脱敏。
• 验收证据不足：仅提交汇总结果，缺少报文、日志、台账和整改记录。质控方案：建立验收资料清单，包含测试用例、接口文档、点位映射表、告警记录、试运行报告与签字确认单。