车主通平台与OBD系统预警信息推送接口规范Ver1.0

需积分: 0 0 下载量 136 浏览量 更新于2024-08-04 收藏 24KB DOCX 举报
"车主通平台提供了与OBD系统交互的接口协议,用于接收和处理来自OBD设备的预警和电子围栏相关信息。该协议基于Http+JSON格式进行数据传输,并包含多个接口,如预警信息推送和电子围栏预警信息推送。在发送请求时,需要包含特定的参数如设备序列号、厂商类型、用户标识、时间戳以及加密的签名。消息体包含了不同的消息类型,如非法启动、异常震动、超速报警等,并提供了相关事件的描述、时间和地理位置信息。" 车主通平台与OBD系统接口协议Ver1.0是用于连接OBD设备和车主通平台的关键规范,它允许OBD系统向平台推送各种预警信息,以实现车辆监控和安全管理。协议中,消息规则的总体定义包括了输入消息和输出消息的结构,其中输入消息要求设备序列号(deviceId)、厂商类型(productType)和用户标识(carUser)作为必要参数。 接口定义部分列出了两个主要接口:预警信息推送接口(/api/obd/pushWarningInfo)和电子围栏预警信息推送接口(/api/obd/pushElecWarningInfo)。这两个接口都期望接收特定的输入参数,并可能返回状态信息。输入参数通常包括deviceId、productType、carUser、时间戳(time)以及通过MD5算法计算的签名(sign),其中password是系统分配的密码。 预警信息推送接口用于传递各种类型的预警信息,如非法启动、异常震动、疲劳驾驶等。消息体包含了code(返回结果标识)、desc(设备唯一标识)、msgType(消息类型)、msgDesc(消息描述)、msgTime(预警发生时间)、longitude(经度)和latitude(纬度)等字段。 电子围栏预警信息推送接口则关注与地理围栏相关的事件,如进入、离开或穿越预设区域。同样,消息体包含msgType、msgDesc、msgTime、longitude、latitude以及状态(state)信息,状态字段表示消息发送是否成功。 这个协议对于C#开发者来说,意味着他们需要熟悉Http请求的构建,理解JSON格式的数据交换,以及如何正确处理MD5加密。同时,开发人员需要处理OBD设备产生的不同预警类型,并适当地响应这些信息,以确保车辆的安全管理和实时监控。