:-: **注意:停车系统与泊链平台的对接方式** 停车收费系统与泊链平台的对接方式有两种,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日零点起到当前时间的秒数,为长整数。