概述

版本历史

版本	时间	描述
V1.0.0	2017年1月 6日	技术接口规范初稿
V1.0.1	2017年1月17日	修改开始充电规范
V1.0.2	2017年2月 7日	增加回调规则
V1.0.3	2017年3月 6日	增加响应示
V1.0.4	2017年4月25日	增加参数加密
V1.0.5	2017年5月19日	增加根据识别码查询桩编号和枪编号接口
V1.0.6	2017年8月11日	增加分时段计费
V1.0.7	2017年9月22日	增加签名和请求规范
V1.0.8	2017年10月19日	简化订单相关的返回参数

目标

随着充电桩企业越来越多，目前各家桩企提供的接口规范都相差较大，为了提高对接效率、保证充电桩的 稳健性，优行科技制定了该技术规范。

规范

• 优行科技基于目前的使用场景，归纳出需要四类接口:认证接口、查询接口、控制接口、回调接口。
• 认证接口、查询接口、控制接口由桩企根据api规范提供接口供优行科技调用
• 回调接口由优行科技根据api规范提供接口供桩企调用
• 所有接口均采用 HTTP(S)的POST方式传输参数
• 请求参数组装成JSON数据格式，然后进行加密
• 接口所需参数建议全部填写，对于不理解的字段可以联系管理员
• 数据加密采用AES/CBC/PKCS5Padding，由优行科技提供加解密秘钥、加解密向量
• 所有关于金额的参数统一以"元"为单位，保留小数点后两位
• 所有时间格式统一为24小时制的"yyyy-MM-dd HH:mm:ss"
• 城市编码参考国标:国标链接

身份校验

名称	含义
appId	身份ID
appKey	公钥，用于身份校验
appSecret	私钥，用于签名
dataSecret	加密秘钥
dataSecretIV	加密向量