# **開放接口，需付費使用，在使用前請確認已經付費，否則只能在測試環境使用且會隨時停掉。**
> **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"}
