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