* **接口描述**
接口功能:下拉未同步的场内车
接口地址:http://......./cloudparkapi/api/queryAgentParkin
> http请求下拉场内车,每次items最多100条,如果items有数据则一直继续拉取,直到items=\[\]无数据为止.
> 拉取后的需要通过 5.2.1.2 接口 上传同步成功 recordNo 结果
* **请求参数说明**
| 字段名称 | 说明 | 类型 | 示例 | 是否必传字段 |
| --- | --- | --- | --- | --- |
| pid | 平台统一分配的pid |String(20) | 123456| 是|
| sign | 请求参数的签名串 |String(32) | FD51E5AA2C541B26E6CA6BAA070AEEB8| 是|
| timestamp | 发送请求的时间(Unix时间戳) |Long |1536547465 | 是|
| bizContent |请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递 | Json | | 是|
bizContent 请求参数约定如下:
| 参数 |数据类型 | 是否必填 | 说明 |
|---|---|---|---|
| page| int | 是 | 当前页 |
| pageSize| int | 是 | 每页记录数 |
| parkCode| String(50) | 是 | 停车场编号,由平台统一分配 |
* **请求示例**
```
{
"pid": "123456",
"serviceName": "queryAgentParkin",
"sign": "D2E8FECFA490EEF362B1A8921CC58D03",
"timestamp": "1536547465",
"bizContent": {
"page": "1",
"pageSize": "2",
"parkCode": "TEST/100014P1499"
}
}
```
* **响应参数说明**
| 参数 |数据类型 | 是否必填 | 说明 |
|---|---|---|---|
| reqId| 消息标志 |String|ae22e99fff094a0e9360f1a7ed0445ac| 是 |
| code | 200-成功,其他是失败 |int | 200 | 是 |
| msg| 结果描述 | String | 成功 | 是 |
| data | Json| 是 | 返回结果|
data 请求参数约定如下:
| 参数 |数据类型 | 是否必填 | 说明 |
|---|---|---|---|
| currentPage| int | 是 |当前页|
| totalPages| int | 是 |总页数|
| totalItems| int | 是 |总数|
| itemsPerPage| int | 是 |每页数|
| items| Json| 是 |数据|
items请求参数约定如下:
| 参数 |数据类型 | 是否必填 | 说明 |
|---|---|---|---|
| recordNo | String(50) | 是 | 入场记录流水号 |
| plateNum| String(20)| 是 | 车牌号 |
| carType |number| 是 | 车辆类型,参照附录车辆类型字典 |
| carSubType | number| 是 | 车辆具体类型,参照附录车辆类型字典 |
| entrance | String(50) | 是 | 入场通道名称 |
| enterTime | String(20)| 是 | 进场时间,格式:YYYY-MM-DD 24HH:mm:ss |
| inChannelid |String(30) | 否 | 入场通道标志 |
| enterOpame | String(50) | 否 | 入场操作人员名称 |
| enterPic |String(100)| 否 | 入场图片地址 |
* **响应示例**
```
{
"reqId": "c967bf31bcc542cfbcf70a5e036340f1",
"code": 200,
"msg": "成功",
"data": {
"currentPage": 0,
"totalPages": 1,
"totalItems": 1,
"itemsPerPage": 2,
"items": [
{
"parkCode": "TEST/100014P1499",
"recordNo": "736f918e9fc447ea9eec0c29f98c9ef1",
"plateNum": "粤A12345",
"carType": 9,
"carSubType": 91,
"entrance": "undefined",
"enterTime": "2023-01-06 19:33:34",
"inChannelid": "云坐席",
"enterOpame": "超管",
"enterPic": ""
}
]
}
}
```
- 一、接入必读
- 1.1 MQ订阅说明
- 主题及数据结构说明(topic)
- 业务类型说明(serviceId)
- 操作类型说明(action)
- 1.2 修订记录
- 二、pts-车场端-服务端
- 2.2 入场记录上报
- 2.3 出场记录上报
- 2.1 在线状态
- 2.4 同步停车订单(废弃)
- 2.5 预出场账单推送
- 2.6 车场信息上报
- 2.7 预入场信息推送
- 2.8 防调头抬闸后超时预警
- 2.9 车场抬闸失败预警
- 2.10 ETC消费记录上报(废弃)
- 2.11手动抬闸记录上报
- 2.12 运行状态信息上报
- 2.13 对讲设备联动-上报
- 2.14 打印机/缴费机设备异常预警
- 2.15 出场取消记录上报
- 2.16 黑名单告警
- 2.17 车场综合告警
- 三、stp-服务端-车场端
- 3.1 查询车辆缴费金额
- 3.2 停车订单支付通知
- 3.3 优惠券领取下发
- 3.4 车辆类型管理
- 3.5 车位组管理
- a. 查询所有车位组-all
- b. 分页查询车位组-query
- c. 添加车位组-add
- d. 修改车位组-edit
- e. 删除车位组-delete
- 附:车位组结构说明
- 3.6 车辆管理
- a. 分页查询所有车辆-query
- b. 添加车辆-add
- c.修改车辆-edit
- d. 删除车辆-delete
- e.车牌变更-change
- f. 充值延期-charge
- g. 冻结-freeze
- h. 解冻-unfreeze
- I. 清空所有车辆-clear
- j.退款
- 附: 车辆结构体说明
- 3.7 根据车牌获取固定车列表
- 3.8 固定车订单支付成功通知
- 3.9 无牌车入场请求
- 3.10 通道管理
- a. 获取通道列表
- b. 指定通道抬闸/落闸
- c. 下发通道二维码
- 3.11 车牌锁定管理
- a.分页查询所有锁定车牌-query
- b.添加车牌锁定-add
- c.修改车牌锁定-edit
- d.删除车牌锁定-delete
- 3.12 车辆场内状态查询
- 3.13 平台控制进出场
- 3.14 访客预约
- 3.15 黑名单管理
- a.查询所有黑名单
- b.添加黑名单
- c.删除黑名单
- 3.16 场内车清理
- 3.17 场内车管理
- a.查询场内车
- b.场内车修改
- c.获取预入场
- 3.18 出场管理
- a.预出场修改
- b.获取预出场
- 3.19 对讲设备联动-下发
- 3.20 车辆管理日志
- a.查询
- 附:车辆管理日志结构体说明
- 3.21 车辆充值套餐
- a 分页查询所有套餐
- 附:充值套餐结构体说明
- 3.22 更新剩余车位
- 3.23 手动入场通知-下发
- 3.24 手动出场通知-下发
- 四、附录
- 车辆类型字典
- 机动车号牌种类字典
- 支付类型字典
- 缴费渠道说明
- 车牌结果来源(设备类型)
- 五、HTTP接口
- 5.1、协议规则与安全规范
- 5.1.1、协议规则
- 5.1.2、安全规范
- 5.2、接入方需实现接口
- 5.2.1、固定车管理
- 5.2.1.1、增加固定车
- 5.2.1.2、删除固定车
- 5.2.1.3、编辑固定车
- 5.2.2、场内车管理
- 5.2.2.1、编辑场内车
- 5.2.2.2、删除场内车
- 5.2.3、查询车辆是否有欠费订单
- 5.2.4、同步场内车到车场
- 5.2.4.1、车场下拉未同步的场内车
- 5.2.1.2、上传场内车同步完成通知
- 5.2.5 物业固定车校验
- 六、附录二
- 6.1 MQ订阅状态检测
- 七、其他
- 7.1 获取车场二维码
