简要描述
- 第三方停车业务接收车辆入场回调通知接口定义规范
- 如果未实现该接口,请不要在设置回调参数中启用该接口,避免无意义的数据通知操作!
示例URL
{{第三方URL}},示例URL:http://localhost:8888/API/V2/OnVehicleIn
注:此处url指的是软件回调给第三方的URL,即第三方要接收软件上传数据的地址;请求方式
- POST
请求类型
- Content-Type:application/json
回调参数说明
| 参数 | 类型 | 参数名 | 是否必填 | 描述 | 说明 |
|---|---|---|---|---|---|
| ParkKey | body | string | yes | 停车场编号 | 本地停车场编号 |
| AppId | body | string | yes | 应用服务标识 | 本地停车场应用服务标识 |
| TimeStamp | body | string | yes | 时间戳 | 时间戳13位,精确到毫秒 |
| Nonce | body | string | yes | 随机字符串 | 随机字符串 |
| Sign | body | string | yes | 接口签名 | 按照接口鉴权生成的签名 |
| Data | body | object | yes | 具体数据 | 对应接口发送的数据对象 |
| » OrderNo | body | string | yes | 停车订单 | 车辆入场时创建的唯一停车订单 |
| » LicensePlateNumber | body | string | yes | 车牌号码 | 车牌号码,注意,车牌号码入参时,默认都转换成大写 |
| » EntryTime | body | string | yes | 入场时间 | 入场时间,参考基本规则中的日期格式,精确到秒,如:2023-08-01 09:34:51 |
| » LicensePlateColor | body | integer | yes | 车牌颜色序号 | 详细信息参考枚举类型/车牌颜色枚举中的序号 |
| » EntryLaneNo | body | string | yes | 入场车道编号 | 入场车道编号 |
| » EntryLaneName | body | string | yes | 入场车道名称 | 入场车道名称 |
| » EntryOperatorName | body | string | yes | 入场操作员 | 入场操作员 |
| » VehicleTypeNo | body | string | yes | 车辆类型编号 | 车辆类型编号 |
| » VehicleTypeName | body | string | yes | 车辆类型名称 | 车辆类型名称 |
| » ParkingCardTypeNo | body | string | yes | 车牌类型编号 | 车牌类型编号 |
| » ParkingCardTypeName | body | string | yes | 车牌类型名称 | 车牌类型名称 |
| » ReserveOrderNo | body | string¦null | yes | 预约车订单号 | 如果该车入场是预约车,则存在预约单号 |
| » ParkingAreaNo | body | string | yes | 停车区域编号 | 当前停车区域编号 |
| » ParkingAreaName | body | string | yes | 停车区域名称 | 当前停车区域名称 |
| » EntryImageUrl | body | string¦null | yes | 入场通行抓拍图片地址 | 入场通行抓拍图片地址,如果启用了云平台并启用了图片存储功能,则这个是一个云端存储图片的地址 |
| » EntryImageBase64 | body | string¦null | yes | 入场通行抓拍图片地址 | 入场抓拍图片的Base64的图片数据,字段不参与签名 |
回调参数示例
{
"ParkKey":"1708773681705596",
"AppId":"p226uwb3",
"TimeStamp":"1709015309519",
"Data":{
"OrderNo":"1708978481390181-EEE666",
"LicensePlateNumber":"粤EEE666",
"EntryTime":"2024-02-26 20:14:36",
"LicensePlateColor":1,
"EntryLaneNo":"1",
"EntryLaneName":"入口车道",
"EntryOperatorName":"超级管理员",
"VehicleTypeNo":"1708773681734708",
"VehicleTypeName":"蓝牌车",
"ParkingCardTypeNo":"1708773681731663",
"ParkingCardTypeName":"临时车A",
"ReserveOrderNo":null,
"ParkingAreaNo":"1708773681832919",
"ParkingAreaName":"外场",
"EntryImageUrl":"",
"EntryImageBase64":null
},
"Nonce":"1762364059234107392",
"Sign":"stpfnmx/04z8jek9eqopskwxrjrrvz7et8xgf4bpwi4="
}
回调返回说明
| 参数 | 类型 | 参数名 | 是否必填 | 描述 |
|---|---|---|---|---|
| ResultCode | integer | true | none | 请求结果代码 |
| ResultMsg | string | true | none | 请求提示信息 |
| Data | object¦null | false | none | 具体数据 |
返回示例
{
"ResultCode": 200,
"ResultMsg": "操作成功"
}作者:mry 创建时间:2024-02-27 14:17
最后编辑:mry 更新时间:2025-10-21 17:37
最后编辑:mry 更新时间:2025-10-21 17:37