ImageVerifierCode 换一换
格式:PDF , 页数:49 ,大小:1.40MB ,
资源ID:1581157      下载积分:5000 积分
快捷下载
登录下载
邮箱/手机:
温馨提示:
如需开发票,请勿充值!快捷下载时,用户名和密码都是您填写的邮箱或者手机号,方便查询和重复下载(系统自动生成)。
如填写123,账号就是123,密码也是123。
特别说明:
请自助下载,系统不会自动发送文件的哦; 如果您已付费,想二次下载,请登录后访问:我的下载记录
支付方式: 支付宝扫码支付 微信扫码支付   
注意:如需开发票,请勿充值!
验证码:   换一换

加入VIP,免费下载
 

温馨提示:由于个人手机设置不同,如果发现不能下载,请复制以下地址【http://www.mydoc123.com/d-1581157.html】到电脑端继续下载(重复下载不扣费)。

已注册用户请登录:
账号:
密码:
验证码:   换一换
  忘记密码?
三方登录: 微信登录  

下载须知

1: 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。
2: 试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓。
3: 文件的所有权益归上传用户所有。
4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
5. 本站仅提供交流平台,并不能对任何下载内容负责。
6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。

版权提示 | 免责声明

本文(DB42 T 2527-2026 充电基础设施公共信息接入与应用规程.pdf)为本站会员(ideacase155)主动上传,麦多课文库仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对上载内容本身不做任何修改或编辑。 若此文所含内容侵犯了您的版权或隐私,请立即通知麦多课文库(发送邮件至master@mydoc123.com或直接QQ联系客服),我们立即给予删除!

DB42 T 2527-2026 充电基础设施公共信息接入与应用规程.pdf

1、ICS35.240.01CCSL 67DB42湖北省地方标准DB42/T 25272026充电基础设施公共信息接入与应用规程Technical specification for public information access and applicationof electric vehicle charging infrastructure2026-02-13 发布2026-04-13 实施湖北省市场监督管理局 发 布DB42/T 25272026I目次前言.III1范围.12规范性引用文件.13术语和定义.14接入内容.15接入信息要求.15.1接入字段要求.15.2数据质量要求.26

2、接入与应用要求.26.1总体架构.26.2接入流程参考.27接口要求.37.1查询运营商信息.37.2查询充换电站信息.47.3推送充换电站信息.57.4查询电池箱信息.57.5推送电池箱信息.67.6推送电池箱状态信息.77.7查询充换电站状态信息.77.8推送充电设备接口状态信息.87.9推送充电状态信息.87.10推送充电订单信息.97.11推送历史充电订单信息.107.12推送换电订单信息.117.13推送充换电站用能统计信息.117.14推送充换电站实时功率.127.15查询充电事故信息.137.16查询补贴发放信息.147.17推送有序放电订单信息.148接入安全要求.158.1数

3、据传输体系.158.2平台认证要求.178.3密钥的管理和使用.199标准实施与评价.209.1实施方法.209.2实施范围.20DB42/T 25272026II9.3条件要求.209.4实施落实情况.209.5实施评价分析.219.6意见反馈.21附录 A(资料性)公共信息对象.22附录 B(资料性)湖北省地方标准实施信息及意见反馈表.42参考文献.43DB42/T 25272026III前言本文件按照GB/T 1.12020标准化工作导则第1部分:标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由湖北华中电力科技开发有

4、限责任公司提出。本文件由国网湖北省电力有限公司归口。本文件起草单位:湖北华中电力科技开发有限责任公司、国网电动汽车服务湖北有限公司、武汉市充换电技术有限公司、湖北省标准化与质量研究院、湖北交投新能源投资有限公司、武汉电动汽车技术开发有限公司、武汉烽火富华电气有限责任公司、武汉腾云慧城科技有限公司。本文件主要起草人:朱银军、陈敬佳、马强、佟翾、李劲松、李晓鹏、何艳、房亮、陶元、徐文渊、姜楠、李婳婧、李航、张帅、罗肖、陈卓、马梓熔、易飞、王黎、朱优明、莫炜罡、季健康、高源、万小莉、刘进、董启旺、谢宇阳、陈磊。本文件实施应用中的疑问或修改意见建议请反馈至国网湖北省电力有限公司,联系电话:027-88

5、566346,邮箱:;或者牵头起草单位湖北华中电力科技开发有限责任公司,联系电话:18607150841,邮箱:。或者湖北省市场监督管理局,联系电话:027-87811019,邮箱:。DB42/T 252720261充电基础设施公共信息接入与应用规程1范围本文件规定了湖北省内充电基础设施公共信息的接入内容、接入信息要求、接入流程、接口要求、接入安全要求、应用和标准实施与评价等。本文件适用于湖北省充电基础设施公共信息接入与应用。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包

6、括所有的修改单)适用于本文件。GB/T 9387.1信息技术 开放系统互连 基本参考模型 第1部分:基本模型GB/T 20271信息安全技术信息系统安全通用技术要求GB/T 22239信息安全技术信息系统安全等级保护基本要求GB/T 25070信息安全技术信息系统等级保护安全设计技术要求3术语和定义下列术语和定义适用于本文件。3.1公共信息public information充电基础设施基础信息及运行信息,例如充换电站档案、充电设备档案、充电设备接口档案、充电订单信息、充电状态信息等。3.2时区time zone为避免不同时区带来的差异,本规程中所提及的时间均采用北京时间(UTC+8)。4接入

7、内容接入对象包括应接入对象、宜接入对象、可拓展对象,其中应接入对象为运营商信息、充换电站信息、充电设备信息、充电设备接口信息、充换电站状态信息、充电设备接口状态信息、充电状态信息、充电订单信息、充电明细信息;宜接入对象为换电设备信息、电池箱信息、电池箱状态信息、换电订单信息、充换电站用能统计信息、充电设备运行统计信息、充电设备接口运行统计信息、充换电站功率信息、充电设备功率信息、充电设备接口功率信息;可拓展对象为补贴发放信息、充电事故信息、有序放电订单信息。具体接入字段可参考附录A。5接入信息要求5.1接入字段要求DB42/T 252720262接入信息内各字段根据实际业务情况分为应接入信息、

8、宜接入信息、可拓展信息,针对各字段存在不同格式要求及业务含义要求,详细定义见附录A。5.2数据质量要求为确保充电基础设施公共信息可正常应用,公共信息数据质量应满足应接入信息无遗漏、宜接入信息与可拓展信息自愿补全、接入信息格式无异常等基础要求,各数据需求方宜通过数据的完整性、有效性、准确性、唯一性、合理性、及时性六个方面自行制定数据质量要求。6接入与应用要求6.1总体架构总体架构见图1,充电运营服务企业基于本规程,通过社会充电运营服务平台对各级新能源汽车充电基础设施公共平台开展信息上报,各级新能源汽车充电基础设施公共平台依托本规程开展信息互联互通,由湖北省新能源汽车充电基础设施公共平台开展对平台

9、间信息共享应用。通过本规程的实施,以规范省内充电基础设施公共信息的共享,加快省内充电基础设施行业快速发展。图 1总体架构图6.2接入流程参考充电基础设施公共信息接入的流程如图2所示,步骤说明如下:a)数据对接方对数据需求方提出数据对接通知;b)数据需求方针对该数据对接方创建技术沟通渠道;c)数据对接方根据数据需求方要求,提供相关资料至数据需求方;d)数据对接方与数据需求方开展测试环境联调、正式环境联调;e)正式环境联调通过后,数据对接方需根据数据需求方要求,开放对应数据权限,开展数据推送,推送完毕后双方需对接入总量进行核对,确保无数据漏传丢失情况;f)数据需求方根据平台内数据治理规则,对接入数

10、据进行治理,若发现异常数据则反馈至数据对接方,并详细告知整改方案;DB42/T 252720263g)数据对接方根据数据需求方反馈的异常数据,开展数据治理,整改后推送至数据需求方;h)数据需求方再次对数据进行治理,若无问题,则完成数据接入流程。图 2接入流程图7接口要求7.1查询运营商信息7.1.1概述此接口用于查询运营商的信息。7.1.2接口定义接口名称:supervise_query_operator_info接口使用方法:由数据提供方实现此接口,数据需求方调用。调用频率:每天至少一次,数据需求方依托实际业务情况,宜选取每日业务低谷时段调用,例如02:0004:00区间调用。7.1.3输入

11、参数DB42/T 252720264查询运营商信息接口输入参数见表1。表 1查询运营商信息输入参数名称定义描述必填类型查询页码PageNo不填写默认为 1是整型每页数量PageSize不填写默认为 50是整型7.1.4返回值查询运营商信息接口返回值见表2。表 2查询运营商信息返回值名称字段描述必填类型当前页数PageNo如果查询页面大于页码总数,返回查询页码数是整型页码总数PageCount总页数是整型总记录条数ItemSize符合条件的总数是整型运营商信息列表OperatorInfos参考公共对象:运营商信息是SupOperatorInfo 数组7.2查询充换电站信息7.2.1概述此接口用于

12、主动查询充换电站信息、充电设备信息、充电设备接口信息。7.2.2接口定义接口名称:supervise_query_stations_info接口使用方法:由数据提供方实现此接口,数据需求方调用。调用频率:每天至少一次,数据需求方依托实际业务情况,宜选取每日业务低谷时段调用,例如02:0004:00区间调用。7.2.3输入参数查询充换电站信息接口输入参数见表3。表 3查询充换电站信息输入参数名称字段描述必填类型运营商 IDOperatorID运营商服务平台 ID否字符串充换电站 ID 列表StationIDs要查询的充电站 ID 列表,不填写,默认全部充电站否字符串数组查询页码PageNo默认为

13、 1是整型每页场站数量PageSize默认为 50是整型最近查询时间LastQueryTime格式“yyyy-MM-dd HH:mm:ss”查询增量数据,更新时间大于等 于此字段的数据否字符串7.2.4返回值查询充换电站信息接口返回值见表4。DB42/T 252720265表 4查询充换电站信息返回值名称字段描述必填类型当前页数PageNo如果查询页码大于页码总数,返回查询页码数是整型页码总数PageCount总页数是整型总记录条数ItemSize符合条件的电站总数是整型充换电站信息列表StationInfos参照公共对象:充换电站信息是SupStationInfo 数组7.3推送充换电站信息

14、7.3.1概述此接口用于充换电站及充换电设备信息发生变化时,推送至数据需求方平台,推送失败时,5分钟内重试推送,若仍失败,则按小时级频率重试推送,直至推送成功。7.3.2接口定义接口名称:supervise_notification_station_info接口使用方法:数据需求方实现此接口,数据提供方调用。调用频率:变化调用7.3.3输入参数推送充换电站信息接口输入参数见表5。表 5推送充换电站信息输入参数名称字段描述必填类型充换电站信息SupStationInfo 对象中的字段参照公共对象:充换电站信息是SupStationInfo7.3.4返回值推送充换电站信息接口返回值见表6。表 6推

15、送充换电站信息返回值名称字段描述必填类型状态Status0:成功1:失败,不需要重试是整型7.4查询电池箱信息7.4.1概述此接口用于主动查询电池箱信息,若平台内无换电业务可不对接此接口。7.4.2接口定义接口名称:supervise_query_battery_pack_info接口使用方法:由数据提供方实现此接口,数据需求方调用。调用频率:每天至少一次,宜选取每日业务低谷时段调用,例如02:0004:00区间调用。DB42/T 2527202667.4.3输入参数查询电池箱信息接口输入参数见表7。表 7查询换电电池箱信息输入参数名称字段描述必填类型运营商 IDOperatorIDs运营商服

16、务平台 ID 列表,不填写,默认全部否字符串数组查询页码PageNo默认为 1否整型每页电池箱数量PageSize默认为 50否整型7.4.4返回值查询电池箱信息接口返回值见表8。表 8查询电池箱信息返回值名称字段描述必填类型查询页码PageNo默认为 1是整型每页场站数量PageSize默认为 50是整型总记录条数ItemSize符合条件的电池箱总数是整型电池箱信息列表BatteryPackInfo参照公共对象:电池箱信息是SupBatteryPackInfo 数组7.5推送电池箱信息7.5.1概述此接口用于充换电站电池箱信息发生变化时,推送至数据需求方平台,推送失败时,5分钟内重试推送,若

17、仍失败,则按小时级频率重试推送,直至推送成功。若平台内无换电业务可不对接此接口。7.5.2接口定义接口名称:supervise_notification_battery_pack_info接口使用方法:数据需求方实现此接口,数据提供方调用。调用频率:变化调用。7.5.3输入参数推送电池箱信息接口输入参数见表9。表 9推送电池箱信息输入参数名称字段描述必填类型电池箱信息SupBatteryPackInfo 对象中的字段参照公共对象:电池箱信息是SupBatteryPackInfo7.5.4返回值推送电池箱信息接口返回值见表10。表 10推送电池箱信息返回值DB42/T 252720267名称字段

18、描述必填类型状态Status0:成功1:失败,不需要重试是整型7.6推送电池箱状态信息7.6.1概述此接口用于电池箱状态信息发生变化时,推送最新的状态信息到数据需求方,推送失败时,5分钟内重试推送,若仍失败,则按小时级频率重试推送,直至推送成功。若平台内无换电业务可不对接此接口。7.6.2接口定义接口名称:supervise_notification_battery_status接口使用方法:由数据需求方实现此接口,数据提供方调用。接口频率:变化推送。7.6.3输入参数推送电池箱状态信息接口输入参数见表11。表 11推送电池箱状态信息输入参数名称字段描述必填类型电池箱状态SupBatteryS

19、tatusInfo对象中的字段参照公共对象:电池箱状态信息是SupBatteryStatusInfo7.6.4返回值推送电池箱状态信息接口返回值见表12。表 12推送电池箱状态信息返回值名称字段描述必填类型状态Status0:成功1:失败是整型7.7查询充换电站状态信息7.7.1概述此接口用于数据需求方批量查询数据提供方的充换电站状态信息。7.7.2接口定义接口名称:supervise_query_station_status接口使用方法:由数据提供方实现此接口,数据需求方调用。调用频率:每天至少一次,数据需求方依托实际业务情况,宜选取每日业务低谷时段调用,例如02:0004:00区间调用。7

20、7.3输入参数DB42/T 252720268查询充换电站状态信息接口输入参数见表13。表 13查询充换电站状态信息输入参数名称字段描述必填类型充换电站 ID 列表StationIDs数组长度不超过 50是字符串数组运营商 IDOperatorID运营商服务平台 ID,字符 9 位是字符串7.7.4返回值查询充换电站状态信息接口返回值见表14。表 14查询充换电站状态信息返回值名称字段描述必填类型充换电站状态信息StationStatusInfos参照公共对象:充换电状态信息是SupStationStatusInfo 数组7.8推送充电设备接口状态信息7.8.1概述此接口用于充电设备接口状态

21、信息发生变化时,推送最新的状态信息给数据需求方;推送失败时,5分钟内重试推送,若仍失败,则按小时级频率重试推送,直至推送成功,数据需求方需依托实际情况制定频繁访问限制,避免设备故障频繁上报对系统造成影响。7.8.2接口定义接口名称:supervise_notification_station_status接口使用方法:由数据需求方实现此接口,数据提供方调用。调用频率:变化推送。7.8.3输入参数推送充电设备接口状态信息接口输入参数见表15。表 15推送充电设备接口状态信息输入参数名称字段描述必填类型充电设备接口状态信息SupConnectorStatusInfo 对象中的字段参照公共对象:充电

22、设备接口状态信息是SupConnectorStatusInfo7.8.4返回值推送充电设备接口状态信息接口返回值见表16。表 16推送充电设备接口状态返回值名称字段描述必填类型状态Status0:接受1:丢弃/忽略,不需要重试是整型7.9推送充电状态信息DB42/T 2527202697.9.1概述此接口用于数据提供方向数据需求方推送充电设备的充电状态;推送失败时,5分钟内重试推送,若仍失败,则按小时级频率重试推送,直至推送成功。7.9.2接口定义接口名称:supervise_notification_equip_charge_status接口使用方法:由数据需求方实现此接口,数据提供方调用。

23、调用频率:4-5分钟。7.9.3输入参数推送充电状态接口的主要输入参数为充电订单号、充电订单状态、充电设备接口编码、相关状态信息和充电明细信息体列表,具体内容参见表17。表 17推送充电状态信息输入参数名称字段描述必填类型充电状态信息SupEquipChargeStatus对象中的字段参照公共对象:充电状态信息是SupEquipChargeStatus7.9.4返回值推送充电状态接口的主要返回值为充电订单号和操作结果,见表18。表 18推送充电状态信息返回值名称字段描述必填类型充电订单号OrderNo格式“运营商 ID+唯一编号”,不超过 64 个字符是字符串操作结果SuccStat0:成功1

24、失败是整型失败原因FailReasonMsg失败原因的描述是字符串失败码FailReasonCode0:成功1:失败是整型7.10推送充电订单信息7.10.1概述此接口用于数据提供方向数据需求方推送充电订单信息;充电订单在充电结束时实时推送,同一订单无异常情况仅可推送一次;推送失败时,5分钟内重试推送,若仍失败,则按小时级频率重试推送,直至推送成功,7天内订单采用该接口进行推送。7.10.2接口定义接口名称:supervise_notification_charge_order_info接口使用方法:由数据需求方实现此接口,数据提供方调用。调用频率:实时。7.10.3输入参数DB42/T 2

25、527202610推送充电订单信息接口的主要输入参数为充电订单号、充电设备接口编码、订单的电量信息、订单的费用信息、订单结束原因和充电明细信息体列表,见表19。表 19推送充电订单信息输入参数名称字段描述必填类型充电订单信息SupChargeOrderInfo对象中的字段参照公共对象:充电订单信息是SupChargeOrderInfo7.10.4返回值推送充电订单信息接口的主要返回值为充电订单号、充电设备接口编码和确认结果,见表20。表 20推送充电订单信息返回值名称字段描述必填类型充电订单号OrderNo格式“运营商 ID+唯一编号”,不超过 64 个字符是字符串充电设备接口编码Connec

26、torID充电设备接口编码,同一运营商内唯一是字符串确认结果ConfirmResult0:成功1:失败否整型7.11推送历史充电订单信息7.11.1概述此接口用于数据提供方向数据需求方推送历史充电订单信息。此接口与补推订单管理办法相结合使用。数据提供方明确推送订单月份,明确推送订单数量。数据需求方根据推送数据规模进行相应的资源调度,提供接口开放时间,数据提供方根据接口开放时间,完成历史充电订单信息数据推送,推送失败时进行协商重试推送,直到推送成功,超出7天订单需数据需求方与数据提供方沟通后使用该接口传输,历史订单推送范围需数据需求方与数据提供方自行沟通明确。7.11.2接口定义接口名称:sup

27、ervise_notification_charge_order_info_history接口使用方法:由数据需求方实现此接口,数据提供方调用。调用频率:约定推送。7.11.3输入参数推送历史充电订单信息接口的主要输入参数为充电订单号、充电设备接口编码、订单的电量信息、订单的费用信息、订单结束原因和充电明细信息体列表,见表21。表 21推送历史订单信息输入参数名称字段描述必填类型充电订单信息SupChargeOrderInfo 对象中的字段参照公共对象:充电订单信息是SupChargeOrderInfo7.11.4返回值推送历史充电订单信息接口的主要返回值为充电订单号、充电设备接口编码和确认结

28、果,见表22。DB42/T 2527202611表 22推送历史订单信息返回值名称字段描述必填类型充电订单号OrderNo格式“运营商 ID+唯一编号”,不超过 64 个字符是字符串充电设备接口编码ConnectorID充电设备接口编码,同一运营商内唯一是字符串确认结果ConfirmResult0:成功1:失败否整型7.12推送换电订单信息7.12.1概述此接口用于推送换电站换电订单信息至数据需求方,同一订单无异常时不可重复推送,推送失败时,5分钟内重试推送,若仍失败,则按小时级频率重试推送,直至推送成功。若平台内无换电业务可不对接此接口。7.12.2接口定义接口名称:supervise_no

29、tification_swap_order_info接口使用方法:由数据需求方实现此接口,数据提供方调用。频率:变化推送。7.12.3输入参数推送换电订单信息接口输入参数见表23。表 23推送换电订单信息输入参数名称字段描述必填类型换电订单信息SupSwapOrderInfo 对象中的字段参照公共对象:换电订单信息是SupSwapOrderInfo7.12.4返回值推送换电订单信息接口返回值见表24。表 24推送换电订单信息返回值名称字段描述必填类型状态Status0:成功1:失败,不需要重试是整型7.13推送充换电站用能统计信息7.13.1概述此接口用于数据提供方向数据需求方推送充换电站用能

30、统计信息,统计时间规则以订单结束时间为基准(即订单结束时间在统计开始时间与统计结束时间区间内);数据不可重复推送,推送失败时,5分钟内重试推送,若仍失败,则按小时级频率重试推送,直至推送成功,重复推送则对已接收数据进行更新。7.13.2接口定义DB42/T 2527202612接口名称:supervise_notification_operation_stats_info接口使用方法:由数据需求方实现此接口,数据提供方调用。调用频率:于次日凌晨1:00至2:00期间,推送前一日运行统计信息。或每日凌晨2:00前,推送前一日运行统计信息。7.13.3输入参数推送充换电站用能统计信息接口输入参数见

31、表25。表 25推送充换电站用能统计信息名称字段描述必填类型充换电站运行统计信息列表StationStatsInfos参照公共对象:充换电站用能统计信息是SupStationStatsInfo7.13.4返回值推送充换电站用能统计信息接口返回值见表26。表 26推送充换电站用能统计信息返回值名称字段描述必填类型状态Status0:成功1:失败是整型7.14推送充换电站实时功率7.14.1概述此接口用于数据提供方推送充换电站实时功率信息。每日0点开始,每间隔15分钟计算一次功率,全天共计算96个时间点功率数据;数据不可重复推送,推送失败时,5分钟内重试推送,若仍失败,则按小时级频率重试推送,直至

32、推送成功,重复推送则对已接收数据进行更新。7.14.2接口定义接口名称:supervise_notification_realtime_power_info接口使用方法:由数据需求方实现此接口,数据提供方调用。调用频率:15分钟推送一次,15分钟内最新的功率信息。7.14.3输入参数推送充换电站实时功率接口输入参数见表27。DB42/T 2527202613表 27推送充换电站实时功率输入参数名称字段描述必填类型充换电站功率统计信息列表SupStationPowerInfos参照公共对象:充换电站功率信息是SupStationPowerInfo7.14.4返回值推送充换电站实时功率接口返回值见

33、表28。表 28推送充换电站实时功率返回值名称字段描述必填类型状态Status0:成功1:失败是整型7.15查询充电事故信息7.15.1概述此接口用于数据需求方查询数据提供方的充电事故信息。7.15.2接口定义接口名称:supervise_query_accident_info接口使用方法:由数据需求方实现此接口,数据提供方调用。调用频率:每天至少一次。7.15.3输入参数查询充电事故信息接口输入参数见表29。表 29查询充电事故信息输入参数名称字段描述必填类型查询页码PageNo默认为 1是整型每页数量PageSize默认为 10是整型上次查询时间lastQueryTimeyyyy-MM-d

34、d HH:mm:ss是字符串7.15.4返回值查询充电事故信息接口返回值见表30。表 30查询充电事故信息返回值名称字段描述必填类型当前页数PageNo如果查询页码大于页码总数,返回查询页码数是整型页码总数PageCount总页数是整型总记录条数ItemSize符合条件的总条数是整型充电事故事故信息列表 EquipmentAccidentInfos参照公共对象:充电事故信息是SupEquipmentAccidentInfoDB42/T 25272026147.16查询补贴发放信息7.16.1概述此接口用于数据需求方查询数据提供方的补贴发放信息。7.16.2接口定义接口名称:supervise_

35、query_subsidy_grant_info接口使用方法:由数据需求方实现此接口,数据提供方调用,宜选取每日业务低谷时段调用,例如02:0004:00区间调用。调用频率:每天至少一次。7.16.3输入参数查询补贴发放信息接口输入参数见表31。表 31查询补贴发放信息输入参数名称字段描述必填类型查询页码PageNo默认为 1是整型每页数量PageSize默认为 10是整型上次查询时间lastQueryTimeyyyy-MM-dd HH:mm:ss是字符串7.16.4返回值查询补贴发放信息接口返回值见表32。表 32查询补贴发放信息返回值名称字段描述必填类型当前页数PageNo如果查询页码大于

36、页码总数,返回查询页码数是整型页码总数PageCount总页数是整型总记录条数ItemSize符合条件的总条数是整型补贴发放信息列表 SubsidyGrantInfo参照公共对象:补贴发放信息是SubsidyGrantInfo7.17推送有序放电订单信息7.17.1概述此接口用于数据提供方向数据需求方推送有序放电订单信息;有序放电订单在放电结束时实时推送,同一订单无异常时仅可推送一次;推送失败时,5分钟内重试推送,若仍失败,则按小时级频率重试推送,直至推送成功。7.17.2接口定义接口名称:supervise_notification_discharge_charge_order_info接口

37、使用方法:由数据需求方实现此接口,数据提供方调用。调用频率:实时。7.17.3输入参数DB42/T 2527202615推送有序放电订单信息接口的主要输入参数为有序放电订单号、充电设备接口编码、订单的电量信息、订单的费用信息、订单结束原因,见表33。表 33推送有序放电订单信息输入参数名称字段描述必填类型有序放电订单信息SupDischargeOrderInfo对象中的字段参照公共对象:有序放电订单信息是SupDischargeOrderInfo7.17.4返回值推送有序放电订单信息接口的主要返回值为有序放电订单号、充电设备接口编码和确认结果,见表34。表 34推送有序放电订单信息返回值名称字

38、段描述必填类型有序放电订单号DischargeOrderNo格式“运营商 ID+唯一编号”,不超过 64 个字符是字符串充电设备接口编码ConnectorID充电设备接口编码,同一运营商内唯一是字符串确认结果ConfirmResult0:成功,表示对此订单的对账确认1:失败否整型8接入安全要求8.1数据传输体系8.1.1数据传输一般流程电动汽车充换电服务信息交换应符合GB/T 9387.1中关于会话连接的要求,一般需要经过平台认证、请求和应答3个步骤。8.1.2数据传输接口数据传输接口应采用 HTTP(S)接口,接口 URL 应按如下格式定义:http(s):/域名/evcs/v版本号/接口名

39、称a)域名:接口提供方平台域名;b)版本号:代表接口版本号,不同的版本地址对应相应版本功能。系统升级期间,新旧版本应同时存在,待所有接入方都切换到新版本接口,旧版本接口即可下线。c)接口名称:所请求/调用接口的名称,具体接口名称见本规程中 7 接口要求d)为保证各接口功能明确清晰,每个接口只允许对应一种功能。8.1.3接口调用方式接口调用应使用HTTP(S)/POST方式,采用APPLICATION/JSON数据提交方式,传输过程中应包含消息头和消息主体两部分。数据应采用UTF-8编码,JSON格式。8.1.4消息头要求DB42/T 2527202616消息头包含内容类型(Content-Ty

40、pe)和授权信息(Authorization)。内容类型字段用于标识请求中的消息主体编码方式,本标准中所定义的信息交换内容均应采用JSON格式,参数信息采用UTF-8编码,消息头中的内容类型配置为application/json;charset=UTF-8。授权信息字段用于证明客户端有权查看某个资源,本标准中所定义的授权信息采用令牌(Token)方式,消息头中的授权信息配置为BearerToken。8.1.5消息主体要求8.1.5.1服务申请运营商标识(OperatorID)、参数内容(Data)、时间戳(TimeStamp)、自增序列(Seq)和数字签名(Sig)组成,具体要求参见表35。表

41、 35消息主体内容表参数名说明备注OperatorID数据请求方的标识-Data各接口具体参数信息Data:Total:1,StationStatusInfos:StationID:111111111111111,ConnectorStatusInfos:ConnectorID:1,Status:4,CurrentA:0,CurrentB:0,CurrentC:0,VoltageA:0,VoltageB:0,VoltageC:0,SOC:10,TimeStamp时间戳接口请求时的时间戳信息,参照GB/T 7408,格式为yyyyMMddHHmmssSeq自增序列4位自增序列取自时间戳,保证唯一

42、性Sig参数签名-8.1.5.2参数返回数据传输接口的返回参数应由返回值(Ret)、返回信息(Msg)、参数内容(Data)和数字签名(Sig)组成,见表36。a)Ret:必填字段,返回参数编码应符合表 36 的规定;b)Msg:必填字段,有错误表示具体错误信息,无错误返回成功信息;c)Data:参数内容,返回参数应符合本规程中的规定。DB42/T 2527202617表 36返回参数编码表Ret 值说明-1系统繁忙,此时请求方稍后重试0请求成功4001签名错误4002Token 错误4003POST 参数不合法,缺少必须的示例:OperatorID,Data,TimeStampSeq,Sig

43、 五个参数4004请求的业务参数不合法,各接口定义自己的正确参数500系统错误1001根据消息体中的组织机构代码,获取不到商户1002加解密异常1003系统繁忙,此时请求方稍后重试1004请求成功8.1.6批量数据传输数据传输接口中的 Data 字段可为 JSON 数组格式,数据发送方可通过该字段实现批量数据的传输。8.2平台认证要求8.2.1基本要求公共服务平台信息交换应具备平台认证功能,提供平台之间的鉴权认证服务。平台之间在信息交换前,需要首先完成平台认证,获得平台交换许可。省级平台、运营服务平台需提供严格的系统安全保密机制,保障信息交换接口安全、稳定、可靠地运行,包括信息的存取控制、应用

44、系统操作的安全等。基本要求:a)采用身份认证、访问控制、数据加密、数字签名等安全措施;b)采用安全可靠并且普遍使用的加密算法;c)密钥的存贮和交易信息的加密解密需要在安全的环境中;d)数据安全保密应遵循国家和行业标准;e)应能定期或应对突发进行密钥更新和启用;f)具备对报文进行来源正确性鉴别的机制,应采用 HMAC 机制。8.2.2认证方式及规则认证宜采取身份认证和访问控制相结合方式,相关流程参见图3。身份认证可采取用户名/口令认证、密钥认证或数字证书认证等方式;访问控制可采取IP访问控制、时间访问控制等多种手段。用户身份认证成功后授予Token,每次向服务端请求资源时应携带服务端签发的Tok

45、en,服务端验证Token成功后,才返回请求的数据。Token的有效期由服务方确定,最长不应超过7天,Token丢失或失效后应再次发起认证服务。DB42/T 2527202618图 3平台认证方式8.2.3接口要求8.2.3.1概述query_token接口用于平台之间认证Token的申请,Token作为全局唯一凭证,调用各接口时均需要使用。8.2.3.2接口定义接口名称:query_token接口使用方法:由服务端实现此接口,由请求端调用。8.2.3.3输入参数运营服务平台认证接口输入参数见表37。表 37运营服务平台认证输入参数参数名称定义参数类型描述运营商标识OperatorID字符串运

46、营商组织机构代码运营商密钥OperatorSecret字符串运营商分配的唯一识别密钥8.2.3.4返回值运营服务平台认证接口返回值见表38。表 38运营服务平台认证返回值参数名称定义参数类型描述运营商标识OperatorID字符串运营商组织机构代码成功状态SuccStat整型0:成功;1:失败获取得凭证AccessToken字符串全局唯一凭证凭证有效期TokenAvailableTime整型凭证有效期,单位秒DB42/T 2527202619表38运营服务平台认证返回值(续)参数名称定义参数类型描述失败原因FailReason整型0:无;1:无此运营商;2:密钥错误;399:自定义8.3密钥的

47、管理和使用8.3.1基本要求公共服务平台、运营服务平台应符合 GB/T 25070、GB/T 20271、GB/T 22239 中关于数据安全传输控制要求。公共服务平台、运营服务平台应提供严格的系统安全保密机制,保障信息交换接口安全、稳定、可靠运行,包括信息的存取控制、应用系统操作的安全等。密钥算法用于密钥的产生、分发、HMAC以及加密等安全功能,相关的算法模块在其生命周期内不应被修改、导出至安全环境外部。指定功能的密钥仅能做指定功能使用,不应被其它任何功能使用。8.3.2密钥的分类交互前应分配唯一标识、运营商密钥、消息密钥、消息密钥初始化向量和签名密钥。并应符合下列要求:a)唯一标识(Ope

48、ratorID):固定 9 位,运营商的组织机构代码/省级平台区域编码(6 位省级区域编码+000),作为唯一标识;b)密钥(OperatorSecret):可采用 16H、32H、48H 和 64H,由 0-F 字符组成,为申请认证使用;c)消息密钥(DataSecret):可采用 16H、32H、48H 和 64H,由 0-F 字符组成,用于对接口调用中 Data 信息进行加密;d)消息密钥初始化向量(DataSecretIV):固定 16 位,用于 AES 加密过程的混合加密;e)签名密钥(SigSecret):可采用 16H、32H、48H 和 64H,由 0-F 字符组成,为签名的加

49、密密钥。8.3.3密钥的管理8.3.3.1密钥的产生数据密钥应具备随机产生特性,密钥产生后应检查密钥的有效性,弱密钥和半弱密钥应被剔除。加入信息交换时,应申请独立的密钥文件,密钥可双方协商产生。8.3.3.2密钥的分发密钥的分发应采用安全方式进行,可通过线下分发、联机报文或数字信封的方式加密传输。8.3.3.3密钥的存储密钥宜保存在硬件加密机内。如需出现在硬件加密机外,则密钥应以密文方式出现。密钥注入、密钥管理和密钥档案的保管应由专人负责。使用密钥和销毁密钥应在监督下进行并应有使用、销毁记录。8.3.3.4密钥的销毁DB42/T 2527202620当新密钥产生后,生命期结束的旧密钥应从数据库

50、和内存中清除,防止被替换使用;同时所有可能重新构造此密钥的信息也应清除。新密钥成功启用和旧密钥自动销毁的记录将被更新。8.3.4密钥的使用8.3.4.1数据的加解密处理消息发送方需要对Data字段数据利用消息密钥(DataSecret)进行加密。消息接收方收到消息之后,根据消息密钥(DataSecret)对消息体中的Data数据进行解密,校验参数合法性后进行后续业务处理。8.3.4.2参数签名要求参数签名应采用HMAC-MD5算法,使用MD5作为散列函数,通过签名密钥(SigSecret)对整个消息主体进行加密,然后采用MD5信息摘要的方式形成新密文,参数签名应大写。参数签名顺序按照消息体顺序

copyright@ 2008-2019 麦多课文库(www.mydoc123.com)网站版权所有
备案/许可证编号:苏ICP备17064731号-1