充电枪充电中数据推送

回调方式: 桩企通过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":"成功"
}