简要描述
  • 该接口用于第三方通知区域余位调整(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:31
最后编辑:yrh  更新时间:2026-10-22 09:35