# **开放接口，需付费使用，在使用前请确认已经付费，否则只能在测试环境使用且会随时停掉。**
> **2019-04-30 除接口7以外其他接口，新加必填字段union_id ，厂商平台账号**
> 所有接口中涉及时间戳格式的字段，精确到秒，传10位数字
### **1.1 接口协议**
接口协议为http，https，Post请求，数据为Base64编码后的字符格式，数据写入请求body中。
返回数据为同步返回Base64位编码数据，
示例：eyJzaWduIjoiNzQzM0M1NDZFOTEzOTkwNjJFNDhDRENBQ0VCOEE2MTUiLCJkYXR hIjp7Im1lc3NhZ2UiOiLnrb7lkI3plJnor68iLCJzdGF0ZSI6MH19
**对返回数据进行Base64解码得到**：
{"sign":"7433C546E91399062E48CDCACEB8A615","data":{"message":"签名错误","state":0}}
**对sign值进行校验，一致则认为是合法数据。**
*****
### **1.2 数据签名**
厂商编号：union_id
厂商秘钥：不需要
车场编号： comid
车场秘钥： ckey
云平台注册车场之后，每个车场有一个车场编号和一个车场秘钥，调用接口时必须传入身份comid和用数据签名。
sign生成方法：对请求中的data数据加上key（ckey），进行MD5并转为大写。
示例：
锁车接口：
测试地址：http://test.bolink.club/zld/lockcar/dolock
原始数据 {"data":{"comid":"kytest2020032501","union_id":"200279","car_number":"晋QQ1234","lock_status":1}}
*****
加上key后组成签名串 {"comid":"kytest2020032501","union_id":"200279","car_number":"晋QQ1234","lock_status":1}key=MAVXUU3C2545G9K1
*****
然后MD5加密后生成下面的sign
sign:4973765089F20FCFE45868796F81278A
*****
**再把sign和原始数据拼在一起如下
{"data":{"comid":"kytest2020032501","union_id":"200279","car_number":"晋QQ1234","lock_status":1},"sign":"4973765089F20FCFE45868796F81278A"}
*****
对上面的数据 进行base64加密，得到以下数据，
并发送以下数据到测试地址http://test.bolink.club/zld/lockcar/dolock
eyJkYXRhIjp7ImNvbWlkIjoia3l0ZXN0MjAyMDAzMjUwMSIsInVuaW9uX2lkIjoiMjAwMjc5IiwiY2FyX251bWJlciI6IuaZi1FRMTIzNCIsImxvY2tfc3RhdHVzIjoxfSwic2lnbiI6IjQ5NzM3NjUwODlGMjBGQ0ZFNDU4Njg3OTZGODEyNzhBIn0=
返回结果
eyJkYXRhIjp7InN0YXRlIjoxLCJtZXNzYWdlIjoi6ZSB5a6a5oiQ5YqfIeaCqOeahOi9pui+huW3sue7j+WkhOS6jumUgeWumueKtuaAgSzor7flnKjlh7rlnLrliY3op6PplIEs5ZCm5YiZ5peg5rOV5Ye65Zy6In0sInNpZ24iOiI0OTczNzY1MDg5RjIwRkNGRTQ1ODY4Nzk2RjgxMjc4QSJ9
解码：
{"data":{"state":1,"message":"锁定成功!您的车辆已经处于锁定状态,请在出场前解锁,否则无法出场"},"sign":"4973765089F20FCFE45868796F81278A"}
