查询充电站信息
1. 接口描述
接口名称:查询充电站信息query_stations_info
接口说明:根据查询条件查询符合条件的电站信息。
请求格式:json
请求方式:post
2. 注意事项
- 该接口符合互联互通标准,需要在消息头中配置Content-Type为application/json、Authorization为Bearer token,消息体中必须包括OperatorID,Data,TimeStamp,Seq,Sig,并且对Data部分进行加密,详细说明请参照AES128位加密和MD5签名。
- 输入参数中PageSize,PageNo缺一不可,并且PageSize最大值为100。
- LastQueryTime建议为空,如果时间距现在较短,由于最近没有电站信息更新,可能会查为空。
- 如果对接的电站数量较多,建议每天更新一次。
- 电费文本格式示例:
"ElectricityFee":"电费:00:00~00:30:5.0000,00:30~01:00:5.0000,01:00~24:00:5.0000"
- 针对电站静态信息更新时间,互联互通平台每天凌晨5点左右会从数据库更新电站数据,来供各合作伙伴查询。当天更改的电站信息,合作伙伴在第二天凌晨5点之后可以获取到。
3. 接口示例
请求Data参数说明:
参数名称 | 定义 | 参数类型 | 描述 |
上次查询时间 | LastQueryTime | string | 查询的起始时间。格式为“yyyy-MM-dd HH:mm:ss”,建议为空,查询所有的充电站信息。默认结束时间为接口请求时间。 |
查询页码 | PageNo | int | 不填写默认为1 |
每页数量 | PageSize | int | 不填写默认为10 |
请求示例:
https://orise.trytowish.cn/evcs/v1/query_stations_info
{
"OperatorID": "123456789",
"Data": "X9a+F3ql9vfyO5tcQV4srGaZm116ly2hAhG1fc0n+TMshLTw1Ax/8AT0NpZRvEhzXPqLeD1n3cVywfU+WScy7a6M9flwrOkJC5QIsp2RlFE=",
"TimeStamp": "20180228173314",
"Seq": "0001",
"Sig": "407FED90C92965C8E456535A72B83F80"
}
Data加密前:
{
"LastQueryTime":"2016-1-2 12:12:12",
"PageNo":1,
"PageSize":1
}
返回Data参数说明:
参数名称 | 定义 | 参数类型 | 描述 |
当前页数 | PageNo | int | 如果查询页码大于页码总数,返回查询页码数 |
页码总数 | PageCount | int | 总页数 |
总记录条数 | ItemSize | int | 符合条件的电站总数 |
充电站信息列表 | StationInfos | StationInfo[] | 类型“StationInfo” |
JSON返回示例:
{
"Ret": 0,
"Msg": "",
"Data": "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",
"Sig": "F12502298D39D1274A7A368733C4BCF1"
}
Data解密后:
{
"StationInfos": [{
"EquipmentInfos": [{
"EquipmentID": "3702810048101",
"EquipmentName": "101号直流",
"ManufacturerID": "395815801",
"ManufacturerName": "奥升物联",
"EquipmentModel": "3907060140040095",
"ProductionDate": "",
"EquipmentType": 1,
"EquipmentLng": 119.996009,
"EquipmentLat": 36.26669,
"Power": 30.0,
"ConnectorInfos": [{
"ConnectorID": "3702810048101",
"ConnectorName": "101号直流",
"ConnectorType": 4,
"VoltageUpperLimits": 500,
"VoltageLowerLimits": 0,
"Current": 60,
"Power": 30.0,
"ParkNo": "",
"NationalStandard": 1
}]
},
{
"EquipmentID": "3702810048103",
"EquipmentName": "103号交流",
"ManufacturerID": "395815801",
"ManufacturerName": "奥升物联",
"EquipmentModel": "M11002B",
"ProductionDate": "",
"EquipmentType": 2,
"EquipmentLng": 119.996009,
"EquipmentLat": 36.26669,
"Power": 7.0,
"ConnectorInfos": [{
"ConnectorID": "3702810048103",
"ConnectorName": "103号交流",
"ConnectorType": 3,
"VoltageUpperLimits": 220,
"VoltageLowerLimits": 0,
"Current": 32,
"Power": 7.0,
"ParkNo": "",
"NationalStandard": 2
}]
},
{
"EquipmentID": "3702810048104",
"EquipmentName": "104号交流",
"ManufacturerID": "395815801",
"ManufacturerName": "奥升物联",
"EquipmentModel": "M11002B",
"ProductionDate": "",
"EquipmentType": 2,
"EquipmentLng": 119.996009,
"EquipmentLat": 36.26669,
"Power": 7.0,
"ConnectorInfos": [{
"ConnectorID": "3702810048104",
"ConnectorName": "104号交流",
"ConnectorType": 3,
"VoltageUpperLimits": 220,
"VoltageLowerLimits": 0,
"Current": 32,
"Power": 7.0,
"ParkNo": "",
"NationalStandard": 1
}]
},
{
"EquipmentID": "3702810048105",
"EquipmentName": "105号交流",
"ManufacturerID": "395815801",
"ManufacturerName": "奥升物联",
"EquipmentModel": "M11002B",
"ProductionDate": "",
"EquipmentType": 2,
"EquipmentLng": 119.996009,
"EquipmentLat": 36.26669,
"Power": 7.0,
"ConnectorInfos": [{
"ConnectorID": "3702810048105",
"ConnectorName": "105号交流",
"ConnectorType": 3,
"VoltageUpperLimits": 220,
"VoltageLowerLimits": 0,
"Current": 32,
"Power": 7.0,
"ParkNo": "",
"NationalStandard": 2
}]
},
{
"EquipmentID": "3702810048106",
"EquipmentName": "106号交流",
"ManufacturerID": "395815801",
"ManufacturerName": "奥升物联",
"EquipmentModel": "M11002B",
"ProductionDate": "",
"EquipmentType": 2,
"EquipmentLng": 119.996009,
"EquipmentLat": 36.26669,
"Power": 7.0,
"ConnectorInfos": [{
"ConnectorID": "3702810048106",
"ConnectorName": "106号交流",
"ConnectorType": 3,
"VoltageUpperLimits": 220,
"VoltageLowerLimits": 0,
"Current": 32,
"Power": 7.0,
"ParkNo": "",
"NationalStandard": 2
}]
}
],
"StationID": "3702810048",
"OperatorID": "395815801",
"EquipmentOwnerID": "395815801",
"StationName": "奥升物联001充电站",
"CountryCode": "CN",
"AreaCode": "370281",
"Address": "北京市海淀区学院路甲8号",
"StationTel": "",
"ServiceTel": "4001-300-001",
"StationType": 1,
"StationStatus": 50,
"ParkNums": 0,
"StationLng": 119.996009,
"StationLat": 36.26669,
"SiteGuide": "圣熙八号北侧",
"Construction": 3,
"Pictures": [
"http://resource.teld.cn/teldimage/115/cc0618ad49024dc2844169d2ba7d0fe4.jpg",
"http://resource.teld.cn/teldimage/115/22ac67cc696b48dab1c1a761a30603bf.jpg",
"http://resource.teld.cn/teldimage/115/39ecf9a403ab47168e36eff7481fa7b5.jpg",
"http://resource.teld.cn/teldimage/115/f197cb8528cc4371a7a420b7df7f5ac7.jpg"
],
"MatchCars": "",
"ParkInfo": "",
"BusineHours": "周一至周日00:00-24:00",
"ElectricityFee": "电费:00:00~24:00:1.1200",
"ServiceFee": "服务费:00:00~24:00:0.6000",
"ParkFee": "免费",
"Payment": "线上",
"SupportOrder": 0,
"Remark": ""
}],
"PageNo": 2,
"PageCount": 584,
"ItemSize": 584
}
设备接口状态查询
1. 接口描述
接口名称:设备接口状态查询query_station_status
接口说明:批量查询设备实时状态
请求格式:json
请求方式:post
2. 注意事项
- 该接口符合互联互通标准,需要在消息头中配置Content-Type为application/json、Authorization为Bearer token,消息体中必须包括OperatorID,Data,TimeStamp,Seq,Sig,并且对Data部分进行加密,详细说明请参照AES128位加密和MD5签名。
- 注意StationIDs是字符串数组类型,数组长度不超过50,请严格按照类型传输。
3. 接口示例
请求Data参数说明:
参数名称 | 定义 | 参数类型 | 描述 |
充电站ID 列表 | StationIDs | 字符串[] | 数组长度不超过50 |
请求示例:
https://orise.trytowish.cn/evcs/v1/query_station_status
{
"OperatorID": "123456789",
"Data": "rQWYvrjEhRG9euPoRD7SI2MRYQdB7KH7bTxnl4Yh9LUZEQ0mEeYbJ3QaRwFQTUJt5VDI/UmyJadRYMn8wb8fqw==",
"TimeStamp": "20180120165755",
"Seq": "0001",
"Sig": "D2D584A14F3F284445DF85D0E8C0697C"
}
Data加密前:
{
StationIDs”: [“3702120022”, “3702120023”]
}
返回Data参数说明:
参数名称 | 定义 | 参数类型 | 描述 |
充电站信息 | StationStatusInfos | StationStatusInfo[] | 根据查询条件设备状态 类型“StationStatusInfo” |
JSON返回示例:
{
"Ret": 0,
"Msg": "",
"Data": "Glr/HxHB/qS9mnFe4R6ZoBs6Mj3DCCEC5+3zfDYvgpt/Qht5nspMUUBxjS10WS74ESWunl+yzTJU1ufPeDhGn4jbAr0BTm8oGGUSDWS2ogV7dl7DyuxbJsbucypTO6QBpgwJH0FGhlYMTPI6P5d22QngyVyfQuN42W45DXJoAxWYyHH5tP6MYKB7LQQUQuO+5Fit6CcVgAC/bC26c/zlYor8XD4ZT4mbFX0qy+eAZaZaALK+0/KiXx8yvvPv7HRQ1ocS/2UnISB81WZpSBMPi1duQzAmcEGIGfKNhWT4wH4=",
"Sig": "58E52010C7DEE87FE183B0AFA5B2BE30"
}
Data解密后:
{
"StationStatusInfos": [{
"StationID": "3702120022",
"ConnectorStatusInfos": [{
"ConnectorID": "3702120022101",
"Status": 4,
}]
},
{
"StationID": "3702120023",
"ConnectorStatusInfos": []
}
],
"Total": 2
}
设备状态变化推送
1. 接口描述
接口名称:设备状态变化推送 notification_stationStatus
接口说明:当设备状态发生变化时,推送最新的状态。
请求格式:json
请求方式:post
2. 注意事项
- 该接口符合互联互通标准,需要在消息头中配置Content-Type为application/json、Authorization为Bearer token,消息体中必须包括OperatorID,Data,TimeStamp,Seq,Sig,并且对Data部分进行加密,详细说明请参照AES128位加密和MD5签名。
- 状态变化推送接口响应时间最大为3s,如果推送过去的终端在系统中不存在,直接扔掉即可,不用给特来电返回异常信息。
- 地锁状态: 0:未知;10:已解锁;50:已上锁;255:故障
- 车位状态: 0:未知;10:空闲;50:占用
3. 接口示例
请求Data参数说明:
参数名称 | 定义 | 参数类型 | 描述 |
充电设备接口状态 | ConnectorStatusInfo | ConnectorStatusInfo | 表示设备的基本情况信息 |
ConnectorStatusInfo数据结构
名称 | 字段 | 描述 | 必填 | 类型 | 长度/范围 |
充电设备接口编码 | ConnectorID | 充电设备接口编码,同一运营商内唯一 | 是 | 字符串 | <=26字符 |
充电设备接口状态 | Status | 0:离网 1:空闲 2:占用(未充电) 3:占用(充电中) 4:占用(预约锁定) 255:故障 | 是 | 整型 | |
车位状态 | ParkStatus | 0:未知 10:空闲 50:占用 | 否 | 整型 | |
地锁状态 | LockStatus | 0:未知 10:已解锁 50:已上锁 | 否 | 整型 |
请求示例:
https://orise.trytowish.cn/evcs/v1/notification_stationStatus
{
"OperatorID": "395815801",
"Data": "4GzfwXXMkoRJsv3melPo78UfLHx6IjSJVD6vdK7z3bXZ+bMLpUSBcBAmfH1GeEJhL4EAJHGhwwgVDrkwTdfyW4Ue7qIiEtR8EekMWU/Fj3upAOeMIrwcPPYEd9/q6dz1oaZeCNN05Tvu0MB2lNSIRQ==",
"TimeStamp": "20180517171155",
"Seq": "0001",
"Sig": "F02EB90C18707E86E2DCF06EEDDA8DDA"
}
Data加密前:
{
"ConnectorStatusInfo": {
"ConnectorID": "3702110116101",
"Status": 1,
"ParkStatus": 0,
"LockStatus": 0
}
}
返回Data参数说明:
参数名称 | 定义 | 参数类型 | 描述 |
状态 | Status | 整型 | 0:接受, |
JSON返回示例:
{
"Ret": 0,
"Msg": "",
"Data": "KXF4GiKV/HYiKvJDbkpcsXl0V8W+Wum5KckdQLFnsqw=",
"Sig": "1A62CA4FD6515B48EBC3CA9BD3F63724"
}
Data解密后:
{
"Status": 0
}
参考标准
T/CEC 102.1-2016 电动汽车充换电服务信息交换 第1部分:总则
T/CEC 102.2-2016 电动汽车充换电服务信息交换 第2部分: 公共信息交换规范
T/CEC 102.3-2016 电动汽车充换电服务信息交换 第3部分: 业务信息交换规范
T/CEC 102.4-2016 电动汽车充换电服务信息交换 第4部分: 数据传输及安全
相关链接
奥升充电|互联互通协议解析(2)——公共信息交换规范-CSDN博客
奥升充电|互联互通协议解析(3)——业务信息交换规范-CSDN博客
奥升新能源技术服务平台https://orise.trytowish.cn/
仓库 | 后端 | 前端 | 小程序 |
---|---|---|---|
Github | 充电平台微服务源码 | 充电管理后台源码 | 充电小程序源码 |
GitCode | 充电平台微服务源码 | 充电管理后台源码 | 充电小程序源码 |
Gitee | 充电平台微服务源码 充电平台微服务源码(备用) | 充电管理后台源码 | 充电小程序源码 |