23、停车系统与车场SDK接口协议

:-:  **注意：停车系统与泊链平台的对接方式**
   
   停车收费系统与泊链平台的对接方式有两种，SDK对接和HTTP对接模式。采用SDK对接请跳过本小结。下面介绍通过HTTP模式对接泊链的具体方法：
与泊链对接涉及接口有：1.1, 2.1, 2.2, 2.3,3.1, 3.2, 3.3,3.4。对接HTTP模式时，上述接口将不再通过调用SDK的UploadUtil方法上传数据，而是采用发送HTTP请求的方式将上行的JSON串包，在http请求header中"Content-Type"设置为"application/json;charset=utf-8"，JSON串数据放置在body中，发送POST请求到泊链服务器。
组织上行数据时, 根据接口文档要求组织的SDK参数, 设为data, 例如初始化, data为:
{"union_id":"200208","park_id":"21835","local_id":"0071cc97102b_1001_qh321_quanhao-atest1"}
然后进行签名, 签名方式为 data数据串+ key=8403A41ED5EF20BC 然后对整串进行md5加密, 得到sign。
即对
{"union_id":"200208","park_id":"21835","local_id":"0071cc97102b_1001_qh321_quanhao-atest1"}key=8403A41ED5EF20BC 进行md5加密。然后将service_name, sign, token, data组成最终的上行JSON格式数据, 例 
{"service_name":"login","sign":"CB649425CB5548A375099103AB04CC1E","data":{"union_id":"200208","park_id":"21835","local_id":"0071cc97102b_1001_qh321_quanhao-atest1"}}
登录时没有token, 故不用添加, 其他接口中, token为必传字段

上行数据的HTTP请求地址：
				
http://ptest.bolink.club/bpd/upload.do (测试平台)
http://p.bolink.club/bpd/upload.do       (正式平台)
               
获取泊链下发的下行数据需采用http轮询的方式,当泊链服务器有需要推送给车场的消息时,会获取JSON格式的下行消息。上行和下行的消息格式与上述SDK接口文档中定义的一致。轮询规则：车场发一个http长轮询请求到泊链，泊链会暂时不返回这个请求，等待30秒后返回无消息，如30秒内有消息会及时返回，车场收到http的返回或者判断超时后应及时再次发起一次请求，确保**有且仅有一个http长轮询请求存在，如果发生断开要车场端主动发起新的连接**。
下行数据的HTTP请求地址：

http://ptest.bolink.club/bpd/download.do  (测试平台)
http://p.bolink.club/bpd/download.do  (正式平台)

下行接口的请求参数(POST)：
|   名称 |  说明  |  类型  |  示例  |   是否必传字段 |
| --- | --- | --- | --- | --- |
token	|初始化后获取的令牌|	String	|6fadf87a5bae43b68a6ae6fc6912f61f	|是

返回状态说明：
|   名称 |  说明  |  类型  |  示例  |   是否必传字段 |
| --- | --- | --- | --- | --- |
state	|状态，1成功，0无消息，-1已离线，需要重新初始化	|Number|	1	|是
data	|数据	|Json|	｛｝|	是
errmsg|	提示信息	|String|	|	否
   
   停车收费系统与SDK之间的调用，数据传入和返回都采为json格式，收费系统调用SDK时，java版本提供一个类名为UploadUtil的对象，提供了一些静态方法，包含了初始化和上行接口的所有方法，每个方法中只有一个参数，为json格式的字符串。接口字段中的时间参数为UTC格式是指从1970年1月1日零点起到当前时间的秒数，为长整数。