HC小区接口文档

删除停车位接口文档

一、接口名称

删除停车位

二、接口描述

用于外系统删除停车位功能

三、接口路径

http://{ip}:{port}/iot/api/parkingSpace.deleteParkingSpace

四、请求方法

POST

五、请求头

参数名称 必填 类型 描述
Authorization String 用户认证token Base token 通过登录接口获取token
app-id String 应用ID 系统dev账户分配
transaction-id String 请求流水号 不能重复 1000000000+YYYYMMDDhhmmss+6位序列
sign String 签名
req-time String 请求时间 YYYYMMDDhhmmss

六、请求参数

6.1 请求体参数

参数名称 必填 类型 长度 描述
psId String 64 停车位编号
communityId String 30 小区ID

七、返回值

7.1 响应体参数

参数名称 必填 类型 长度 描述
code int 11 返回编号,0 成功 其他失败
msg String 250 描述信息

八、示例请求

{
  "psId": "22",
  "communityId": "2022081539020475"
}

九、示例响应

{
  "code": 0,
  "msg": "成功"
}

十、业务逻辑说明

  1. 接口会先验证请求参数中必须包含psId和communityId字段
  2. 将请求参数转换为ParkingSpacePo对象
  3. 调用IParkingSpaceV1InnerServiceSMO接口的deleteParkingSpace方法删除停车位数据
  4. 如果删除失败(返回影响行数<1),则抛出CmdException异常
  5. 删除成功则返回成功响应

十一、注意事项

  1. 该接口需要事务支持(@Java110Transactional)
  2. 删除操作是物理删除,会直接从数据库中移除记录
  3. 调用方需要确保psId和communityId的正确性