1.2 车场初始化(SDK 4.2 及后续版本)
时间:2022/3/16 10:43:58 点击:
SDK 4.2 及后续版本支持车场软件上行接口加密传输;
初始化及下行接口无需加密
1、车场调用 http 请求到云平台获取公钥
如果本地软件未升级、不支持加密传输,可忽略该操作,直接初始化即可正常使用
请求地址::http://yun.bolink.club/zld/sdkSecurity/getPublicKey
调用方式:POST
请求参数:
| 字段名称 | 说明 | 类型 | 示例 | 是否必传字段 |
|---|---|---|---|---|
| union_id | 厂商编号 | Number | 200002 | 是 |
| park_id | 车场编号 | String | 21787 | 是 |
同步返回内容:
| 字段名称 | 说明 | 类型 | 示例 | 是否必传字段 |
|---|---|---|---|---|
| state | 状态 | Number | 0失败1成功 | 是 |
| msg | 方法返回描述 | String | 获取成功 | 是 |
| public_key | 车场公钥 | String | MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCSz+Uw1Z0EYzDekusCk+FzhOd9gvuy/+LG9e/mn7bDkztYa2abs4N6dE6XzZjsa6T/nNF4VC865/8RqO+BSB2F7wNbG0QzVmcVpk51kYCoiZzsgdUJ+HGLyadAyWcMOb6zRQqxXeu7M10nizkQbXfLIPZN02QEIzCJXMQuew | 是 |
2、车场初始化
车场SDK与停车收费系统集成时,收费系统调用SDK提供的初始化方法,初始化一些身份信息。
Java版本的调用方法名为UploadUtil.init(String jsonData),调用时,把所有参数按json对象格式组成字符串,作为参数给java方法。
字段信息:
| 名称 | 说明 | 类型 | 最大长度 | 示例 | 是否必传字段 |
|---|---|---|---|---|---|
| union_id | 厂商平台账号 | String | 15 | 200002 | 是 |
| ukey | 厂商平台密钥 | String | 24 | EA2D90FEEF1E9F8E | 是 |
| park_id | 车场编号 | String | 24 | 3251 | 是 |
| cloud_addr | 停车云域名 | String | 18 | 测试环境:test.parkingos.club;正式环境:1029.parkingos.club | 是 |
| cport | 停车云端口 | Number | 10 | 6789 | 是 |
| local_id | 收费系统编号,同一车场的收费系统编号不可重复,车场存在多个收费系统集成sdk时,必传,车场sdk初始化参数中的local_id,可以按规则包含通道信息,用关键字channels后加下划线加通道号(通道号可由数字、字母、中文组成),多个时用下划线分隔,结尾不要加下划线,如local_id=mac001,需要绑定A1、A2、A3三个通道,那就写为local_id=aaa001_channels_A1_A2_A3,那么这个sdk就管理了三个通道:A1,A2,A3。在泊链后台生成入场或出场二维码,输入的通道号在这个sdk管理中,车主扫带该通道号二维码时,泊链会把入场或出场消息发给这个sdk(在线),如果sdk不在线,则不发送。 | String | 196 | 22AA | 否 |
| log_show | sdk是否打印日志 | number | 2 | 0不打印日志,1打印,默认0 | 否 |
| set_params | 设置参数,扩展参数,见下表说明 | json | 48 | {"prepay_send":"1"} | 否 |
扩展参数
| 名称 | 说明 | 类型 | 最大长度 | 示例 | 是否必传 |
|---|---|---|---|---|---|
| prepay_send | 接收预付消息,0不收,1接收 | String | 2 | 1 | 否 |
| month_send | 接收公众号月卡续费消息,0不收,1接收 | String | 2 | 1 | 否 |
| receive_cloud | 接收云平台下行消息,0不收,默认1接收 | string | 2 | 1 | 否 |
| prepay_query | 是否接收预付查询,0不接收预付查询 ,其他设置不生效 | number | 2 | 0 | 否 |
| fast | 是否同步返回,设置true后上行接口除了2.1和2.2之外都是同步返回,不再异步,默认是false | number | true | 否 | |
| autoconnect | 断网是否重连,默认1自动重连。 0代表不自动,1代表自动;4.2及以后版本有效 | number | 1 | 否 |
jsonData数据示例
{"union_id":"200002","ukey":"EA2D90FEEF1E9F8E","park_id":"3251","cloud_addr":"test.parkingos.club","cport":6789,local_id”:"aaa001_channels_A1_A2_A3","set_params":{"prepay_send":"1","month_send":"1","receive_cloud":"1"}}
车场初始化同步返回:
| 名称 | 说明 | 类型 | 最大长度 | 示例 | 是否必传 |
|---|---|---|---|---|---|
| state | 状态 | Number | 2 | 0失败1成功 | 是 |
| errmsg | 方法返回描述 | String | 48 | Init success! | 是 |
示例:{"state":1,"errmsg":"Init success! "}
- 上一篇:1.3反初始化 2022/3/16
- 下一篇:1.1初始化(废弃版本) 2022/3/16
