编辑停车位
一、接口名称
编辑停车位信息
二、接口描述
该接口用于修改指定停车位的基本信息，包括车位编号、面积等属性。
三、接口路径
serviceCode: parkingSpace.editParkingSpace
四、请求方法
POST
五、请求头
| 参数名称 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | String | 用户认证token |
| app-id | 是 | String | 应用ID |
| transaction-id | 是 | String | 请求流水号 |
| sign | 是 | String | 签名 |
| req-time | 是 | String | 请求时间(YYYYMMDDhhmmss) |
六、请求参数
6.1 请求体参数（JSON格式）
| 参数名称 | 必填 | 类型 | 描述 | 约束 |
|---|---|---|---|---|
| communityId | 是 | String | 小区ID | 不能为空 |
| psId | 是 | String | 停车位ID | 必须为已有ID，不能以"-"开头 |
| paId | 是 | String | 停车场ID | 不能为空 |
| num | 是 | String | 车位编号 | 不能为空 |
| area | 是 | String | 车位面积 | 不能为空 |
| parkingType | 否 | String | 车位类型 | 子母车位不能修改类型 |
七、返回值
7.1 响应格式（JSON）
| 参数名称 | 类型 | 描述 |
|---|---|---|
| code | String | 返回码(0-成功) |
| msg | String | 返回信息 |
| data | Object | 返回数据 |
八、示例请求
POST /api/parkingSpace/editParkingSpace
Headers:
Authorization: Bearer xxxx
app-id: hc-community
transaction-id: 100000000020231201143000123456
sign: xxxxxxx
req-time: 20231201143000
Body:
{
"communityId": "702022082207300001",
"psId": "742022082207300001",
"paId": "732022082207300001",
"num": "A-101",
"area": "12.5",
"parkingType": "001"
}
九、示例响应
{
"code": "0",
"msg": "成功",
"data": null
}
十、错误码
| 错误码 | 描述 |
|---|---|
| 1001 | 未包含小区ID |
| 1002 | 停车位ID不能为空 |
| 1003 | 未查询到停车位信息 |
| 1004 | 子母车位类型修改限制 |
| 1005 | 修改车位失败 |
十一、业务逻辑说明
- 验证必填参数完整性
- 校验停车位ID有效性（不能为负数）
- 查询并验证停车位存在性
- 特殊处理子母车位类型修改限制
- 更新停车位信息
- 返回操作结果
十二、数据库操作
- 通过
parkingSpaceInnerServiceSMOImpl.queryParkingSpaces查询现有车位信息 - 通过
parkingSpaceV1InnerServiceSMOImpl.updateParkingSpace更新车位信息
十三、注意事项
- 子母车位（TYPE_CD_SON_MOTHER）与其他车位类型不能互相转换
- 修改操作会保留原车位的state状态
- 需要确保paId对应的停车场存在