1 、对接流程
- 1.1 与技术支持获取测试参数: OrgId,密钥(requestKey),测试车场ID
- 1.2 对接开发,根据需求选择对接API列表接口
- 1.3 上线运行,对接调试成功后,向技术支持提供线上车场ID,分配正式参数。
2、技术要求
- 框架协议
- 通讯协议:以 HTTP POST ‘Content-Type: application/json;charset=UTF-8’ 格式请求
- 请求方式:所有请求参数通过结构化数据(JSON)进行传递
- 字符编码: UTF-8
- 数据内容(3个接口)
- 进出场记录接口(推送)
- 获取车辆信息接口
- 缴费回调接口
3、 请求报文结构
- 公共请求参数
字段 | 类型 | 空 | 描述 | 实例 |
---|---|---|---|---|
service | String | 否 | 服务名称 | |
version | String | 否 | 版本 | 01 |
timestamp | String | 否 | 时间戳(安全验证) | |
orgId | String | 否 | 机构ID(分配) | |
body | Object | 否 | 具体接口body详情json对象 | |
sign | String | 否 | 请求签名 | 请查看签名生成规则 |
4、 签名加密
- 所有后台接口均进行加密验证,接入方在调用任何接口时均需要对原始请求进行签名,后台接
口签名进行校验,如果签名不正确,则接口不允许被调用。 - 签名算法采用 MD5 计算,URL 请求中所有非空的参数值都要参与加密,参数加密的时候要按照
参数名首字母的 ascii 值升序排列,并在拼接的串末尾加上 requestKey,最后将整个串进行 MD5
加密
Sign 生成规则:
(1)将所有参数进行自然排序;
(2)在排序之后的字符串末尾加上参数:
示例:orgId=Org_2021001&service=inOutList×tamp=1637029193649&version=V1&carType=0&cashCharge=0.0&epayCharge=0.0&inLane=1&inLaneName=车道1&inTime=2021-09-07 17:53:53&ioStatus=0&needCharge=0.0&outLane=0&parkCode=YDT_42012&parkType=1&plate=粤B12348&uniqueId=420121631008433&fK5OEj4HENZFOU5qokqqwJwhpUB1JRCK
(3)将字符串进行 MD5 加密即为 sign