回调方式: 桩企通过POST的方式,向优行提供的地址(见1.2)发送回调信息
应用场景: 桩企充电枪在充电中时,桩企通过充电枪充电中数据推送接口向优行科技每隔两分钟推送一次电枪的实时数据
接口签名:详见1.3签名认证
接口地址(生产环境): https://charging.caocaokeji.cn/pileinfo/open/gunData
接口地址(沙箱环境): http://sandbox.caocaokeji.cn/sand-box-charge-pile-gateway/caocao/v2/pileinfo/open/gunData
注:该接口使用特定域名
接口流程:
请求参数
参数名称 | 类型 | 备注 |
---|---|---|
appId | String | 桩企身份ID |
timeStamp | number | 秒级时间戳 |
sign | String | data+timeStamp组成的参数签名 |
data | String | 加密后数据 |
请求data参数:
子类名 | 返回参数名 | 类型 | 是否必填 | 备注 |
---|---|---|---|---|
cityCode | String | 必填 | 城市编码 | |
stationNo | String | 必填 | 站点编号 | |
gunInfo | List | 必填 | 站点下枪充电中数据 |
gunInfo:
子类名 | 返回参数名 | 类型 | 是否必填 | 备注 |
---|---|---|---|---|
stubId | String | 必填 | 桩编号 | |
gunId | String | 必填 | 枪编号 | |
ratedVoltage | number | 必填 | 额定电压(单位:V) | |
ratedCurrent | number | 必填 | 额定电流(单位:A) | |
soc | number | 非必填 | 电池百分比(整数0-100)【直流充电时返回】 | |
power | number | 非必填 | 已充电电量,需要精确到4位小数 | |
parkStatus | int | 非必填 | 车位状态 0:未知; 1:空闲;2:占用 | |
lockStatus | int | 非必填 | 地锁状态 0:未知;1:已解锁;2:已上锁 | |
orderId | String | 非必填 | 桩企的订单编号【属于曹操订单时返回】 |
响应参数
参数名称 | 类型 | 是否必填 | 备注 | 示例 |
---|---|---|---|---|
code | string | 必填 | 返回码 | 100 |
success | boolean | 必填 | 是否成功 | true |
message | string | 必填 | 返回码描述 | 成功 |
请求示例:
{
"appId": "123456789",
"timeStamp": 1505374350,
"sign": "8D5AD1A57D30956CC946CFFDFCFD4AE3",
"data": {
"cityCode": "330100",
"stationNo": "234567899090",
"gunInfo": [
{
"stubId": "324235465765",
"gunId": "1",
"ratedVoltage": "354.20",
"ratedCurrent": "2.4",
"soc": "20",
"power": "1.2",
"parkStatus": 2,
"lockStatus": 2
},
{
"stubId": "324235465765",
"gunId": "2",
"ratedVoltage": "344.20",
"ratedCurrent": "1.4",
"soc": "60",
"power": "20.2",
"parkStatus": 2,
"lockStatus": 2
}
]
}
}
响应示例:
{
"code":"100",
"success":true,
"message":"成功"
}