* **接口描述**
接口功能:添加固定车。
接口地址:http://......./cloudparkapi/api/addfixcar
* **请求参数说明**
| 字段名称 | 说明 | 类型 | 示例 | 是否必传字段 |
| --- | --- | --- | --- | --- |
| pid | 平台统一分配的pid |String(20) | 123456| 是|
| sign | 请求参数的签名串 |String(32) | 3990ECB4F297A1F758C430B022D2F8C5| 是|
| timestamp | 发送请求的时间(Unix时间戳) |Long |1536547465 | 是|
| bizContent |请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递 | Json | | 是|
bizContent 请求参数约定如下:
| 字段名称 | 类型 | 说明 | 是否必传字段 | 示例 |
| --- | --- | --- | --- | --- |
| uuid| String | 车辆信息唯一标识 | 是 | 11AMX0PAN00CAY54IAG61CX900IE2U3B |
| carNum| String | 车牌号码 | 是 | 京A54321 |
| owner | String | 车主 |否 |张三 |
| cartypeCode| int | 车辆类型编码<br/>具体参考车辆类型定义| 是 | 81 |
| carspaceNum| String | 车位号码 | 否 | pk123 |
| tel| String | 车主电话 | 否 | 13800001111 |
| carMMoney| float| 月租金额 | 是| 200.00 |
| balance| float | 储值车余额 | 是| 200.00|
| timeStart| String | 开始时间 <br/>yyyy-MM-dd hh:mm:ss| 是| 2020-12-12 00:00:00|
| timeEnd| String | 过期时间 <br/>yyyy-MM-dd hh:mm:ss| 是| 2021-12-12 00:00:00|
| cargroupUuid| String | 车位组唯一标识<br/>无车组为空| 是 | 22AMX0PAN00CAY54IAG61CX900IE2U3B |
| remark| String | 备注1| 是 | 111 |
| remark1| String | 备注2| 是 | 222 |
| remark2| String | 备注3| 是 | 333 |
| state| int| 启用状态 <br/>0:禁用 1:启用| 是| 1|
* * *
> 示例
~~~
{
"pid": "123456",
"sign": "3990ECB4F297A1F758C430B022D2F8C5",
"timestamp": "1536547465",
"bizContent": {
"uuid":"11AMX0PAN00CAY54IAG61CX900IE2U3B",
"carNum":"京A54321",
"owner ":"张三",
"cartypeCode":81,
"carspaceNum":"pk123 ",
"tel":"13800001111 ",
"carMMoney":200.00,
"balance":200.00,
"timeStart":"2020-12-12 00:00:00",
"timeEnd":"2021-12-12 00:00:00",
"cargroupUuid":"22AMX0PAN00CAY54IAG61CX900IE2U3B",
"remark":"111",
"remark1":"222",
"remark2":"333",
"state":1
}
}
~~~
返回信息:
| 字段名称 | 说明 | 类型 |示例 | 是否必传字段 |
| --- | --- | --- | --- | --- |
| reqId| 消息标志 |String|ae22e99fff094a0e9360f1a7ed0445ac| 是 |
| code | 200-成功,其他是失败 |int | 200 | 是 |
| msg| 结果描述 | String | 成功 | 是 |
* * *
> 示例:
~~~
{
"reqId": "ae22e99fff094a0e9360f1a7ed0445ac",
"code": 200,
"msg": "成功"
}
~~~
- 一、接入必读
- 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 获取车场二维码
