简要描述
- 该接口用于第三方通知区域余位调整(query 参数 Route 固定传
ParkSpace)。 NoticeType为 0 时表示矫正余位(新增或更新);NoticeType=1 时,Items传空数组或 null 表示重置全部区域,传区域列表则只重置指定区域。- Route 参数大小写敏感,必须与示例完全一致。
请求URL
http://localhost:8888/Api/V2/OpenApi/Notice
请求方式
- POST
请求类型
- Content-Type:application/json
请求参数
Query参数
| 参数 | 类型 | 参数名 | 是否必填 | 描述 | 说明 |
|---|---|---|---|---|---|
| Route | query | string | yes | 路由信息 | 固定传 ParkSpace(大小写敏感) |
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 | yes | 具体数据 | 对应接口发送的数据对象 |
| » NoticeType | body | integer | yes | 通知类型 | 0:矫正余位(新增或更新);1:重置余位 |
| » Items | body | [object] | NoticeType=0 必填 | 数据集合 | NoticeType=0 时必填且最多 50 条;NoticeType=1 时可传空数组(重置全部)或指定区域列表 |
| »» AreaNo | body | string | yes | 区域编号 | 区域的唯一标识 |
| »» RemainSpace | body | integer | NoticeType=0 时必填 | 矫正后余位 | 区域最终展示的余位,必须 ≥0 且不能大于区域总车位数;NoticeType=1 时忽略此字段 |
请求示例
矫正余位(NoticeType=0)
{
"ParkKey": "{{parkkey}}",
"AppId": "{{appid}}",
"TimeStamp": "{{timestamp}}",
"Nonce": "vqnkpzhigqhm",
"Sign": "rcjmptcxcqaqszkczkotjuny",
"Data": {
"NoticeType": 0,
"Items": [
{
"AreaNo": "A001",
"RemainSpace": 50
},
{
"AreaNo": "B002",
"RemainSpace": 20
}
]
}
}重置余位(NoticeType=1,重置指定区域)
{
"ParkKey": "{{parkkey}}",
"AppId": "{{appid}}",
"TimeStamp": "{{timestamp}}",
"Nonce": "vqnkpzhigqhm",
"Sign": "rcjmptcxcqaqszkczkotjuny",
"Data": {
"NoticeType": 1,
"Items": [
{
"AreaNo": "A001"
}
]
}
}重置余位(NoticeType=1,重置全部区域)
{
"ParkKey": "{{parkkey}}",
"AppId": "{{appid}}",
"TimeStamp": "{{timestamp}}",
"Nonce": "vqnkpzhigqhm",
"Sign": "rcjmptcxcqaqszkczkotjuny",
"Data": {
"NoticeType": 1,
"Items": []
}
}返回参数说明
| 参数 | 类型 | 参数名 | 是否必填 | 描述 | 说明 |
|---|---|---|---|---|---|
| ResultCode | integer | true | none | 请求结果代码 | 200:操作成功;1002:参数或业务校验不通过;1003:未知异常 |
| ResultMsg | string | true | none | 请求提示信息 | 矫正成功返回”矫正余位成功!”;重置成功返回”重置余位成功!”;失败返回相应错误信息 |
| ResultId | string | true | none | 请求响应结果标识 | 每一次进行接口请求时,响应本次处理的标识 |
| Data | object¦null | false | none | 具体数据 | 成功时不返回(null) |
返回示例
矫正余位成功
{
"ResultCode": 200,
"ResultMsg": "矫正余位成功!",
"ResultId": "500303426998440",
"Data": null
}重置余位成功
{
"ResultCode": 200,
"ResultMsg": "重置余位成功!",
"ResultId": "500303426998441",
"Data": null
}校验失败(示例)
{
"ResultCode": 1002,
"ResultMsg": "区域[A001]的矫正后余位不能大于区域总车位数!",
"ResultId": "500303426998442",
"Data": null
}作者:yrh 创建时间:2026-10-22 09:50
最后编辑:yrh 更新时间:2026-10-22 09:50
最后编辑:yrh 更新时间:2026-10-22 09:50