标准摘要
【主要技术内容】 第一章 数据传输与安全 2 1 数据传输体系 2 1.1 数据传输流程 2 1.2 数据传输接口 2 1.3 接口调用方式 2 1.4 消息头规范 2 1.5 消息主体规范 2 2 平台认证要求 5 2.1 基本要求 5 2.2 认证方式及规则 5 3 认证接口规范 Token 5 3.1 接口定义 5 3.2 输入参数 6 3.3 返回值 6 4 密钥的管理和使用 6 4.1 基本要求 6 4.2 密钥的分类 7 4.3 密钥的管理 7 4.4 密钥的使用 7 5 数据加解密方式 8 5.1 数据加解密方法 8 5.2 数据加解密示例 8 6 参数签名方式 8 6.1 HMAC-MD5 参数签名方法 8 6.2 HMAC-MD5 参数签名流程 8 6.3 参数签名示例 9 7 秘钥使用 9 第二章 公共数据对象 9 1 换电运营商信息(OperatorInfo) 9 2 换电场地信息(SwapStationInfo) 10 3 换电站信息(SwapEquipmentInfo) 13 4 充电机/充电仓接口信息(BatChargeMachineConnectotInfo) 15 5 配电信息(BatDisEquipmentInfo) 16 6 电池包信息(BatteryPackageInfo) 18 7 车辆信息(VehicleInfo) 20 8 换电订单信息(BatSwapOrderInfo) 20 9 换电订单详情信息(BatSwapOrderDetailInfo) 23 10 电池包充电过程信息(BatChargingBMSInfo) 24 11 充电机/充电仓接口充电过程信息(SwpEquipmentChargingStatusInfo) 26 12 电池包充电记录信息(BatChargeRecordInfo) 28 13 配电计量信息(BatDisEquipmentStatusInfo) 33 第三章 公共数据接口 35 1 运营商信息注册 35 2 获取token信息 35 2.1 接口描述 35 2.2 请求路径 35 2.3 请求方法 35 2.4 请求格式 35 2.5 请求参数 35 2.6 请求示例 35 2.7 响应参数 36 2.8 响应数据示例 36 3 推送换电站信息 36 3.1 接口描述 36 3.2 请求路径 37 3.3 请求方法 37 3.4 请求格式 37 3.5 请求参数 37 3.6 请求示例 37 3.7 响应参数 39 3.8 响应数据示例 39 4 推送配电设备信息 40 4.1 接口描述 40 4.2 请求路径 40 4.3 请求方法 40 4.4 请求格式 40 4.5 请求参数 40 4.6 请求示例 40 4.7 响应参数 41 4.8 响应数据示例 41 5 推送电池包信息 41 5.1 接口描述 41 5.2 请求路径 42 5.3 请求方法 42 5.4 请求格式 42 5.5 请求参数 42 5.6 请求示例 42 5.7 响应参数 43 5.8 响应数据示例 43 6 推送车辆信息 43 6.1 接口描述 43 6.2 请求路径 44 6.3 请求方法 44 6.4 请求格式 44 6.5 请求参数 44 6.6 请求示例 44 6.7 响应参数 45 6.8 响应数据示例 45 7 推送换电订单信息 45 7.1 接口描述 45 7.2 请求路径 45 7.3 请求方法 46 7.4 请求格式 46 7.5 请求参数 46 7.6 请求示例 46 7.7 响应参数 47 7.8 响应数据示例 47 8 推送电池包充电过程信息 48 8.1 接口描述 48 8.2 请求路径 48 8.3 请求方法 48 8.4 请求格式 48 8.5 请求参数 48 8.6 请求示例 49 8.7 响应参数 49 8.8 响应数据示例 49 9 推送充电机/充电仓接口充电过程信息 50 9.1 接口描述 50 9.2 请求路径 50 9.3 请求方法 50 9.4 请求格式 50 9.5 请求参数 51 9.6 请求示例 51 9.7 响应参数 51 9.8 响应数据示例 52 10 推送电池包充电记录 52 10.1 接口描述 52 10.2 请求路径 52 10.3 请求方法 53 10.4 请求格式 53 10.5 请求参数 53 10.6 请求示例 53 10.7 响应参数 55 10.8 响应数据示例 55 11 推送配电计量信息 55 11.1 接口描述 55 11.2 请求路径 56 11.3 请求方法 56 11.4 请求格式 56 11.5 请求参数 56 11.6 请求示例 56 11.7 响应参数 57 11.8 响应数据示例 57