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 日零点起到当前时间的秒数，为长整数。