定义
平台对接（Platform Integration）指物联网平台与第三方系统（如 充电平台、物流平台、ERP、CRM）通过 API、标准协议或中间件实现数据与业务互联。平台对接是实现 互操作性 的关键手段，使设备管理、计费、运维等能力可跨系统协同。在跨境充电漫游、跨境物流、多平台聚合等场景中，平台对接支撑 OCPI、OCPP 等标准协议及自定义 API 的集成。
技术特点与架构
平台对接技术特点包括：标准化协议——如 OCPI、OCPP 用于充电；RESTful API——设备状态、CDR、用户等数据的同步；消息队列——异步事件推送与 数据同步；松耦合——通过 松耦合 设计降低系统间依赖。典型架构包括：API 网关、协议适配层、数据同步 与映射、安全认证（OAuth、API Key）。跨境场景需考虑多时区、多货币、多语言及各地数据合规（如数据本地化）。
在物联网与跨境场景中的应用
平台对接在物联网与跨境场景中的应用包括：充电漫游——充电平台 与 eMSP、聚合商的 OCPI 对接，实现跨境充电与结算；设备管理——设备管理平台 与客户业务系统的设备、流量、告警对接；物流——物流平台 与仓储、运输、报关系统的对接；运维——运维平台 与工单、客服系统的对接。达希物联支持与客户平台的灵活对接，助力跨境物联网业务落地。
平台对接里字段、事件与幂等
平台对接是两套系统对同一业务对象达成可核验的交换。对象可能是卡、设备、充电会话、抄表读数或工单。交换方式可以是请求响应，也可以是事件通知。无论哪一种，双方都要有一份写明版本的字段表：名称、类型、单位、时区、是否可空、枚举取值。字段表没有版本号时，一方加了“状态”取值，另一方仍按旧枚举丢弃，看起来像数据没有上报。跨境接口还要写明金额用哪种货币的最小单位，电量用瓦时还是千瓦时，时间是带偏移的完整时刻还是无时区的本地字符串。
事件用来传递已经发生的变化，例如会话闭合、变位、越界。接收方必须能识别重复投递。幂等键应来自业务标识，如会话号加闭合次数，而不是来自每次重试新生成的随机数。随机数会让同一次闭合变成两张账单。拉取与推送若同时开启，要用同一幂等键去重，否则夜间对账会看到双份电量。失败响应要区分“暂时不可用、可以重试”和“字段非法、重试也无效”，后一种继续重试只会堵住队列。
联调可以切到生产的前提
切到生产的条件是：沙箱里用过与生产相同的版本和枚举，时钟偏差在约定范围内，鉴权凭证按环境分开，限流和超时已经写入双方的预期，并且有一份失败样例被双方确认过处理方式。只验证成功路径是不够的。应至少走通一次重复投递、一次字段缺失、一次迟到的补传。补传要能落在原来的账期，而不是算进补传当天。若拜访地和归属地的平台分属不同主体，还要确认谁有权更正已接收的记录，以及更正报文如何引用原记录。
同名不同义造成的错账
常见差错是两边都有 energy 或 amount 字段，一边是瓦时、一边是千瓦时，金额差出一千倍才被发现。其次是结束时间用了服务器收到时间，会话在跨境链路上迟到，时长被算短或算到下一小时的费率。再次是错误码未分类，网络闪断触发无限重试，把同一详情记录写成多笔。还有一种是只对接了查询接口，没有事件，平台以为状态实时，实际上要等下一轮拉取。枚举值用展示文案而不是稳定代码，语言一切换就解析失败。上线清单应固定单位、幂等键、时间语义和错误分类，并用一笔已知读数做端到端比对，而不是只看接口返回成功。
上线后的第一周应每天用一笔已知读数做端到端比对，比对项包括电量或用量、货币最小单位、开始与结束的时区以及幂等键是否只生成一笔账单。比对失败时先停写生产账，保留原始报文。沙箱凭证和生产凭证分开存放，避免联调脚本误向生产重放。对方增加枚举值时，未知取值应进入隔离队列并告警，不能静默丢弃，否则新状态上线后看起来像设备不再上报。隔离队列里的报文在字段表更新后按原幂等键重放。已知读数取自表计或桩本地的冻结值，不由接收方自行编造。
比对记录保存报文原文和冻结值来源，便于区分是单位换算错误还是时区错误。连续多日比对一致之后，再恢复日常的批量写入。未知枚举仍留在隔离队列，不进入正式账单。