免费注册 登录
    客服电话:15825274336
新闻资讯 系统更新 公司新闻 运营技巧 常见问题 行业资讯 SEO常识
当前位置

滴滴互联互通对接规范

行业资讯 2020-12-23 17:53 标签:充电, 共享充电
滴滴互联互通对接规范

一、 目的
滴滴为更快速、顺利地完成与各政府、企业的互联互通对接,保障系统的按时上线与稳定运行,编写此说明。

二、 对接准备

1. 对接前,请同BD确认是否走完商务流程。
2. 需提供一名技术负责人配合对接,技术负责人至少应具备以下知识:
ü 具有软件系统开发的经验;
ü 对充电流程有一定的了解;
ü 理解《电动汽车充换电服务信息交换标准》(简称《标准》)
建议阅读顺序:先看第一部分,再看第四部分,第二部分和第三部分先看附录,再看正文。
3、 第四部分所需交换的信息
开放平台->快速接入有提供测试秘钥
正式环境->等待上线申请通过后,下发独立配置。


三、 接口对接标准
对接的平台需要提供下列标准接口和扩展接口,系统对接时,1-13号接口为强制要求的接口,14以上为可选接口。

必选标准接口:
以下接口为对接方必须提供的接口列表,接口的命名和参数规范兼容中电联标准,缺少相应接口将会影响系统对接和线上生产环境使用。
1. 请求token接口:query_token
2. 设备认证接口:query_equip_auth
3. 查询业务策略:query_equip_business_policy
4. 启动充电接口:query_start_charge
5. 停止充电接口:query_stop_charge
6. 查询充电状态:query_equip_charge_status
7. 查询充电站状态:query_station_status
8. 获取充电站信息:query_stations_info
回传通知接口:
9. 通知启动充电结果:notification_start_charge_result
10. 通知充电站状态:notification_stationStatus
11. 通知停止充电结果:notification_stop_charge_result
12. 通知设备充电状态:notification_equip_charge_status
13. 通知充电订单信息:notification_charge_order_info

可选扩展接口:
参考《小桔充电开放平台技术文档》
14. 通过二维码查询枪号 query_terminal_code
15. 推送站信息变化 notification_stationInfo
16. 查询充电站信息 query_station_info
17. 查询充电枪信息 query_connector_status

四、 问题处理
1. 为沟通方便,对接时会建立技术沟通微信群,请提供相关负责人的姓名、电话、微信号、邮箱,方便对接问题的及时处理;
2. 对接问题也可发邮件给bixiaowei@didiglobal.com   trentchentao@didiglobal.com  zhanglongbin@didiglobal.com 

五、 接口联调
5.1 充电校验联调
  5.1.1 正式环境扫码
供应商提供码的规范、是否符合中电联标准,给出常见码的样本图片。
需要保证所有枪必须有二维码,尤其是一桩多枪的情况,需保证用户可以在无需指导前提下确定枪对应的二维码。
需要保证所有枪的枪号明显,用户在无需指导前提下,都能在线下找到对应的枪号,保证用户因为光线等问题无法扫码时,可以通过输入充电枪号的形式启动充电。如果因为极端原因无法提供线下枪号,如需进行二次开发,需要主动联系滴滴进行提前开发工作。

  5.1.2 正式环境获取枪、站信息,操作上线等
供应商需保证正式环境枪id和桩id在不同站的唯一性。提前告知滴滴开通正式环境接口,以便滴滴方进行线下实地勘察,填入图片、经纬度等辅助信息。

中电联标准中规范了枪信息以推送的形式告知接入方,供应商需提前告知滴滴推送频率、推送范围,以便滴滴方对全网的枪信息进行状态感知。

供应商需保证正式环境可用,如果桩站出现停用、施工等额外情况,第一时间在互联互通接口中去掉相关桩站。如果出现了行政区划变更,请及时更新area_code 字段。

供应商需保证正式环境可用,如果出现枪损坏、不支持普通用户充电的桩,第一时间在互联互通接口中去掉相关枪和桩。

  5.1.3 价格策略校验
对接供应商需要提前走完商务流程,告知对应的折扣信息。

需要保证所有线上可用桩站的价格不为空。出现价格为空的桩站,第一时间通知我方运营人员协商下线相关操作。

  5.1.4 认证信息等校验
供应商需提供设备认证失败的错误码,给出有效提示以便辅助用户定位问题。

5.2 充电过程联调
充电过程包括同步请求的响应和回调响应。
前提:供应商需保证在符合中电联标准的前提下,尽可能详细给出错误信息,以便滴滴方第一时间定位问题,并给出用户有效、有益的辅助信息。

   5.2.1 发启动请求能否正常启动
供应商需保证发起充电后,能够执行完车桩匹配检测等各个环节,需提前给出接口中字段IdentCode相关解释。

   5.2.2 充电中查询状态是否正确
供应商需提前沟通,充电过程中状态推送的频率,并支持查询充电状态接口。

   5.2.3 是否能正常停止
供应商需保证下发停止命令后,停止服务的高可用性,如果出现设备离网等情况,需提前结束充电流程。

   5.2.4 充电回调信息是否正确
供应商需保证回调信息正确性,尤其是保证在下发启动充电指令之后,进行启动回调,并提供成功与否的正确响应。

   5.2.5 能否正常账单计费
需要保证账单回调接口的及时性、高可用性,务必保证账单回调收到正确响应后再停止投递账单。

  5.2.6 关键信息校验(电费、服务费、电量、电流、SOC)
供应商需保证关键信息的准确性。

5.3充电异常流程测试(
昆明网站建设 
供应商需提供车桩匹配信息,以便出现充电问题时,滴滴方辅助解决问题。
    双方定期组织沟通,讨论目前存在的异常问题的主要原因,提高充电成功率。

5.4 服务性能测试(
昆明网站建设 
供应商需保证服务性能,尤其是为了保证线上服务的稳定性、高可用性、可伸缩性,进行容量预估和性能压测。
性能测试需满足线上产品对并发用户数、请求响应时间、事务响应时间、每秒请求数、吞吐率、业务成功率、TPS的要求。具体细节需双方技术、产品、测试团队协商解决。供应商应重点关注请求响应时间,并保证同步接口的响应时间在500ms内。


5.5 接口内部实现注意事项
5.5.1 query_equip_charge_status 返回信息要与startChargeSeq(订单号)对应起来,部分供应商会返回该订单对应枪的其他订单信息。

5.5.2 notification_charge_order_info务必及时推送订单信息,其中费用信息应拆分电费和服务费,订单信息应包含充电明细信息ChargeDetails,明细信息中每个分段应包含分段电量、分段电费、分段服务费等信息,对分段电量还应满足如下要求:
l 电量的分段不超过48个,

l 相邻分段时间连续且首尾时间应等于充电开始和充电结束时间,

l 各分段电量之和应等于订单累计电量,

l 充电开始时间早于充电结束时间,订单创建时间早于充电结束时间。

5.5.3 query_equip_business_policy

l StartTime 开始时间段必须是 00000

5.5.4 query_stations_info

l ServiceTel 必须是16位以内

六、 验收上线
l 正式上线之前运营商在商开放平台进行API测试,充电模拟+上线申请。(充电模拟只有正常结束,才能进行上线申请,如有特殊问题,请联系区域运营询问开发人员)(
昆明网站建设 

l 上线审核通过后,下发正式环境配置。(运营商在上线申请页面查看审核结果,进行线上配置)

l 双方上线后可联系区域运营进行线下实车测试。

l 线下实车测试通过后由区域运营完成上线工作。

版本记录 (
昆明网站建设 

版本 修改记录 修改人
V  1.0 新建文档 Lianyadong
V  1.1 增加接口联调部分 Lianyadong
V  1.2 增加必选接口 Xingyuefu
V  1.3 增加联系人信息 Lianyadong
V  1.4 修改接口联调部分 Fanzhaolong
V  1.5 修改部分逻辑 Fanzhaolong
V  1.6 明确二维码及枪号规范 Fanzhaolong
V  1.7 更换联系人邮件 Bixiaowei
V  1.8 增加接口实现的注意事项 Bixiaowei
V  1.9 增加接口实现的注意事项 Wanghaipeng



昆明网站建设 
  • 上一篇:病毒变异元旦还能出行吗?
  • 下一篇:拼多多卖劳斯莱斯,补贴122万!10万人想拼:能砍成免费吗?
  • 相关文章

    行业资讯

    运营技巧

    案例

    热门关键词

    产品咨询
    在线客服QQ 411536303 电话15825274336 扫一扫咨询
    产品咨询
    X