为了保证数据传输的安全,平台需对发送的内容做签名验证。
### **平台为接入合作方分配一个pid和key**
签名生成的通用步骤如下:
**第一步**,将所有发送的数据内非空参数值的参数按照参数名 ASCII 码从小到 大排序(字典序),使用 URL 键值对的格式(即 key1=value1&key2=value2...) 拼接成字符串 StringTemp。
特别注意以下重要规则 :
* 参数名ASCII码从小到大排序(字典序);
* 如果参数的值为空不参与签名;
* 参数名区分大小写;
* 传送的sign参数不参与签名,将生成的签名与该sign值作校验;
* 云平台可能增加字段,验证签名时必须支持增加的扩展字段;
**第二步**,在字符串 StringTemp 最后拼接上 Key得到 signTemp 字符串。
**第三步**,对 signTemp 进行 MD5 运算,再将得到的字符串所有字符转换为大 写,得到 sign 值 signValue。
### **举例说明:**
假设传送的参数如下:
pid = 123456
serviceName = enterNotify
timestamp = 1539571096
bizContent ={"enterTime":"2018-01-01 11:00:00","parkCode":"TEST/1P1","plateNum":"粤B12345"}
**第一步**:对参数按照参数名 ASCII 字典序排序,并按照 key=value 的格式拼接成字符串StringTemp ,如下: ********
bizContent={"enterTime":"2018-01-01 11:00:00","parkCode":"TEST/1P1","plateNum":"粤B12345"}&pid=123456&serviceName=enterNotify×tamp=1539571096
**第二步**:拼接密钥 Key: signTemp=StringTemp+"&key=45DC1F8604F940829E75D6A76595C299"
**第三步**:对 signTemp 进行 MD5 运算
sign=MD5(signTemp).toUpperCase()
**按照上述步骤,签名结果为: EE454BE0DE3D211559865DA33745E589**
- 一、接入必读
- 1.1 MQ订阅说明
- 主题及数据结构说明(topic)
- 业务类型说明(serviceId)
- 操作类型说明(action)
- 1.2 修订记录
- 二、pts-车场端-服务端
- 2.2 入场记录上报
- 2.3 出场记录上报
- 2.1 在线状态
- 2.4 同步停车订单(废弃)
- 2.5 预出场账单推送
- 2.6 车场信息上报
- 2.7 预入场信息推送
- 2.8 防调头抬闸后超时预警
- 2.9 车场抬闸失败预警
- 2.10 ETC消费记录上报(废弃)
- 2.11手动抬闸记录上报
- 2.12 运行状态信息上报
- 2.13 对讲设备联动-上报
- 2.14 打印机/缴费机设备异常预警
- 2.15 出场取消记录上报
- 2.16 黑名单告警
- 2.17 车场综合告警
- 三、stp-服务端-车场端
- 3.1 查询车辆缴费金额
- 3.2 停车订单支付通知
- 3.3 优惠券领取下发
- 3.4 车辆类型管理
- 3.5 车位组管理
- a. 查询所有车位组-all
- b. 分页查询车位组-query
- c. 添加车位组-add
- d. 修改车位组-edit
- e. 删除车位组-delete
- 附:车位组结构说明
- 3.6 车辆管理
- a. 分页查询所有车辆-query
- b. 添加车辆-add
- c.修改车辆-edit
- d. 删除车辆-delete
- e.车牌变更-change
- f. 充值延期-charge
- g. 冻结-freeze
- h. 解冻-unfreeze
- I. 清空所有车辆-clear
- j.退款
- 附: 车辆结构体说明
- 3.7 根据车牌获取固定车列表
- 3.8 固定车订单支付成功通知
- 3.9 无牌车入场请求
- 3.10 通道管理
- a. 获取通道列表
- b. 指定通道抬闸/落闸
- c. 下发通道二维码
- 3.11 车牌锁定管理
- a.分页查询所有锁定车牌-query
- b.添加车牌锁定-add
- c.修改车牌锁定-edit
- d.删除车牌锁定-delete
- 3.12 车辆场内状态查询
- 3.13 平台控制进出场
- 3.14 访客预约
- 3.15 黑名单管理
- a.查询所有黑名单
- b.添加黑名单
- c.删除黑名单
- 3.16 场内车清理
- 3.17 场内车管理
- a.查询场内车
- b.场内车修改
- c.获取预入场
- 3.18 出场管理
- a.预出场修改
- b.获取预出场
- 3.19 对讲设备联动-下发
- 3.20 车辆管理日志
- a.查询
- 附:车辆管理日志结构体说明
- 3.21 车辆充值套餐
- a 分页查询所有套餐
- 附:充值套餐结构体说明
- 3.22 更新剩余车位
- 3.23 手动入场通知-下发
- 3.24 手动出场通知-下发
- 四、附录
- 车辆类型字典
- 机动车号牌种类字典
- 支付类型字典
- 缴费渠道说明
- 车牌结果来源(设备类型)
- 五、HTTP接口
- 5.1、协议规则与安全规范
- 5.1.1、协议规则
- 5.1.2、安全规范
- 5.2、接入方需实现接口
- 5.2.1、固定车管理
- 5.2.1.1、增加固定车
- 5.2.1.2、删除固定车
- 5.2.1.3、编辑固定车
- 5.2.2、场内车管理
- 5.2.2.1、编辑场内车
- 5.2.2.2、删除场内车
- 5.2.3、查询车辆是否有欠费订单
- 5.2.4、同步场内车到车场
- 5.2.4.1、车场下拉未同步的场内车
- 5.2.1.2、上传场内车同步完成通知
- 5.2.5 物业固定车校验
- 六、附录二
- 6.1 MQ订阅状态检测
- 七、其他
- 7.1 获取车场二维码
