简要描述
- 该接口用于实现管理新增、更新、删除月租车记录
- 注意:在停车场系统中车主名下的车共享同一个开始时间和结束时间,并且只能发布一种月租车类型;如果当初新增或更新操作时,同一个车主传入了多个车辆信息,最终按照结束时间排序,结束时间最大的数据作为参考数据更新到数据库!
版本差异说明
注:对比旧版本,v3.8版本新增部分字段
- 可停区域集合【可停区域(StopSpaceList)、区域可停车位数(SpaceCount)】、
- 卡号(CardNo)、
- 车主备注(OwnerRemarks)
关于通知类月租车接口相关描述
1、No、ParkingSpotNumber、0wnerNo 字段唯一,相同时为更新,不同时为新增
2、一位多车,首次新增车辆信息时,下发两个车牌,如果后续再下发一个,会更新第一个车牌号码,不会新增。
3、一位多车,首次新增两个车牌号,第二次请求时加入新车牌或者修改首次的2个车牌,软件只会更新第一个车牌,其它车牌不做更新和新增
4、已入场月租车,通过接口注销,会变更为临时车,再次登记会关闭上一个订单请求URL
http://localhost:8888/Api/V2/OpenApi/Notice
请求方式
- POST
请求类型
- Content-Type:application/json
请求参数
Query参数
| 参数名 | 类型 | 示例值 | 说明 |
|---|---|---|---|
| Route | string | MonthlyCar | 接口路由 |
Body参数
| 参数 | 类型 | 参数名 | 是否必填 | 描述 | 说明 |
|---|---|---|---|---|---|
| ParkKey | body | string | yes | 停车场编号 | 本地停车场编号 |
| AppId | body | string | yes | 应用服务标识 | 本地停车场应用服务标识 |
| TimeStamp | body | string | yes | 时间戳 | 时间戳13位,精确到毫秒 |
| Nonce | body | string | yes | 随机字符串 | 随机字符串 |
| Sign | body | string | yes | 接口签名 | 按照接口鉴权生成的签名 |
| Data | body | object¦null | yes | 具体数据 | 对应接口响应的数据对象 |
| » NoticeType | body | integer | yes | 通知类型 | 通知类型:0.新增或更新 1.删除 |
| » Items | body | [object] | yes | 通知数据集合 | 通知数据集合 |
| »» No | body | string | yes | 记录编号 | 表示当前记录的编号,唯一值 |
| »» LicensePlateNumber | body | string¦null | yes | 车牌号码 | 车牌号码,注意,车牌号码入参时,默认都转换成大写 |
| »» ParkingSpotNumber | body | string¦null | yes | 车场车位号 | 车场车位号 |
| »» OwnerParkingSpaceCount | body | integer | yes | 车主车位数 | 车主车位数 |
| »» OwnerName | body | string¦null | yes | 车主名称 | 发行车辆记录的车主名称 |
| »» OwnerNo | body | string¦null | yes | 车主编号 | 记录车主的唯一标识编号 |
| »» OwnerIDCard | body | string¦null | yes | 车主身份证信息 | 车主身份证信息 |
| »» OwnerLicense | body | string¦null | yes | 车主驾驶证 | 车主驾驶证 |
| »» OwnerAddress | body | string | yes | 车主住址 | 车主居住地址 |
| »» PhoneNumber | body | string | yes | 手机号码 | 手机号码 |
| body | string¦null | yes | 邮箱地址 | 邮箱地址 | |
| »» StartTime | body | string¦null | yes | 开始时间 | 开始时间,参考基本规则中的日期格式,精确到秒,如:2023-08-01 09:34:51 |
| »» EndTime | body | string¦null | yes | 结束时间 | 结束时间,参考基本规则中的日期格式,精确到秒,如:2023-08-01 09:34:51 |
| »» StoredVehicleBalance | body | number | yes | 储值车余额 | 储值车余额,单位元,精确到后两位小数点 |
| »» VehicleTypeNo | body | string¦null | yes | 车辆类型编号 | 车辆类型编号 |
| »» ParkingCardTypeNo | body | string¦null | yes | 车牌类型编号 | 车牌类型编号 |
| »» OperatorName | body | string¦null | yes | 操作人姓名 | 操作人姓名 |
| »» Remarks | body | string¦null | yes | 车辆备注信息 | 车辆备注信息 |
| »» OwnerRemarks | body | string¦null | yes | 车主备注信息 | 车主备注信息 |
| »» CardNo | body | string¦null | yes | 车辆卡号 | 车辆卡号,不足10位时回前置补0 |
| »» EnableOffline | body | integer | yes | 白名单使能 | 相机离线自动开闸(白名单):0-禁用,1-启用 |
| »» IsDeleteOwner | body | boolean | yes | 是否删除车主信息 | 当执行删除操作时,是否一起删除车主信息,注意删除车主信息时,车主关联的车辆信息将一并被删除 |
| »» StopSpaceList | body | [object] | yes | 可停区域集合 | 可停区域集合 |
| »»» AreaNos | body | [string¦null] | no | 区域编号(车场区域编码) | 兼容两种格式:JSON数据字符串,如[“1789049646659912”];或单个编号字符串 1789049646659912 空值[“0”]或 0 表示全部区域 |
| »»» SpaceCount | int | [string¦null] | no | 可停车位数(区域可停车位数) | 未填或为0时,根据OwnerParkingSpaceCount判断可停车位数,有填则以这个优先 |
注意:一次添加多个可停区域(AreaNos),传OwnerParkingSpaceCount,不传spacecount,软件会默认为0,因此建议
AreaNos和SpaceCount同步使用
请求示例
{
"ParkKey": "{{parkkey}}",
"AppId": "{{appid}}",
"TimeStamp": "{{timestamp}}",
"Nonce": "dvrscrdgxrob",
"Sign": "xicygpfwjipwbbnjysopoklv",
"Data": {
"NoticeType": 0,
"Items": [
{
"No": "630000201108254378",
"LicensePlateNumber": "粤P12345",
"ParkingSpotNumber": "56",
"OwnerParkingSpaceCount": 2,
"OwnerName": "ces",
"OwnerNo": "410000199701311192",
"OwnerIDCard": "82",
"OwnerLicense": "测试",
"OwnerAddress": "山",
"PhoneNumber": "18100000009",
"Email": "b.ypwwtiqst@qq.com",
"StartTime": "2024-02-27 11:04:31",
"EndTime": "2024-02-27 11:04:31",
"StoredVehicleBalance": 101.88646804833,
"VehicleTypeNo": "1708773681734708",
"ParkingCardTypeNo": "1708773681731399",
"OperatorName": "管理员",
"Remarks": "这是一个显眼的备注信息",
"EnableOffline": 1,
"IsDeleteOwner": false
}
]
}
}返回参数说明
| 参数 | 类型 | 参数名 | 是否必填 | 描述 | 说明 |
|---|---|---|---|---|---|
| ResultCode | integer | true | none | 请求结果代码 | 详细信息请查看类型枚举/请求结果代码枚举,默认200为操作成功 |
| ResultMsg | string | true | none | 请求提示信息 | 接口请求返回的信息提示 |
| ResultId | string | true | none | 请求响应结果标识 | 每一次进行接口请求时,响应本次处理的标识 |
| Data | object¦null | false | none | 具体数据 | 对应接口响应的数据对象 |
返回示例
{
"ResultCode": 200,
"ResultMsg": "本次新增或更新操作成功!",
"ResultId": "1762312991271845888"
}作者:yrh 创建时间:2026-10-21 11:09
最后编辑:yrh 更新时间:2026-10-21 11:37
最后编辑:yrh 更新时间:2026-10-21 11:37