客户嘴上说「要对接」,实际需求通常只有三类:看到电池实时状态、出异常时收到通知、能远程做几个动作。先对齐这三类,再谈接口数量。
状态查询。按柜、按电池、按点位查当前状态。要有批量接口,否则客户做日报要循环调几千次。
历史数据。按时间段查某块电池的电压、温度、SOC。要分页,并且明确返回的时间是设备采集时间还是服务器接收时间。
告警推送。Webhook 方式,带签名、事件 ID、重试策略。
指令下发。远程断充、限流、重启柜控。必须有执行回执查询。
台账与归属。电池编号、所属点位、当前状态。客户做资产盘点要用。
一、时间口径不一致。一方用 UTC、一方用本地时间,报表对不上。开头就写死。
二、电池标识不统一。柜、平台、客户系统三处编号对不上,就会出现「同一块电池被当成两块」的对账问题。约定以某一处为准,其余做映射。
三、告警重复推送。没有幂等键,客户侧收到十条同样的告警,于是干脆把通知关了。
四、限流没提前说。客户按天全量拉取,直接把接口打挂,双方一起排障。
五、字段含义靠猜。SOC 是 0–100 还是 0–1、温度是摄氏度还是华氏度,文档里没写,联调时才发现全错。
| 类别 | 必带内容 |
|---|---|
| 状态 | 单查 + 批量 + 字段口径 |
| 历史 | 分页 + 采集时间 + 精度说明 |
| 告警 | 签名 + 事件 ID + 重试 |
| 指令 | 下发 + 回执状态 |
| 台账 | 编号 + 归属 + 状态 |
对接前先出一页字段约定,比联调时逐项对省得多。
数据对接失败,很少是技术不通,多是口径没定。先把「时间、标识、单位、重复」四件事写在文档里,联调能省一半时间。
翼微云自助设备长期做自助设备与换电柜的物联网改造,平台与联网硬件为成熟方案,可按现有柜体与电池直接对接。咨询 400-611-9786,项目定制 153-6158-6789。
面向集成商、工程商与业主提供整体方案咨询、设备改造对接与系统定制服务,可对接各行业设备接入翼微云物联网平台(SaaS)。