充电枪实时状态变更推送接口

回调方式: 桩企通过POST的方式,向优行提供的地址(见1.2)发送回调信息

应用场景: 桩企充电枪产生空闲、故障、充电中等状态变更时,都通过回调接口向优行科技推送枪的实时状态。

接口签名:详见1.3签名认证

接口地址(生产环境): https://charging.caocaokeji.cn/pileinfo/open/gunStatus

接口地址(沙箱环境): http://sandbox.caocaokeji.cn/sand-box-charge-pile-gateway/caocao/v2/pileinfo/open/gunStatus

注:该接口使用特定域名

接口流程

充电枪实时状态变更推送接口

请求参数

参数名称 类型 备注
appId String 桩企身份ID
timeStamp number 秒级时间戳
sign String data+timeStamp组成的参数签名
data String 加密后数据

请求data参数:

子类名 返回参数名 类型 是否必填 备注
cityCode String 必填 城市编码
stationNo String 必填 站点编号
stubId String 必填 桩编号
gunId String 必填 枪编号
status int 非必填 枪状态变更前的状态
状态码:
0:空闲1:充电中2:故障3:车位占用4:维护中5:离线6:在建中7:升级中9:储能中99:删除
currentStatus int 必填 当前电枪状态
状态码同status
chargeType int 必填 充电类型 0:交流 1:直流

响应参数

参数名称 类型 是否必填 备注 示例
code string 必填 返回码 100
success boolean 必填 是否成功 true
message string 必填 返回码描述 成功

请求示例:

{
    "appId": "123456789",
    "timeStamp": 1505374350,
    "sign": "8D5AD1A57D30956CC946CFFDFCFD4AE3",
    "data": {
        "cityCode": "330100",
        "stationNo": "234567899090",
        "stubId":"324235465765",
        "gunId": "1",
        "status": 0,
        "currentStatus": 1,
        "chargeType": 0
    }
}

响应示例:

{
    "code":"100",
    "success":true,
    "message":"成功"
}