新增楼栋

POST

https://api2.hik-cloud.com/api/v1/estate/system/buildings

功能描述

向社区下添加楼栋。

返回码

返回码	返回消息	描述
510001	参数错误	必填项为空、参数长度不符合等参数异常情况
511000	社区不存在
511001	该社区下楼栋已存在，无法添加
511004	楼栋编号已经存在
511059	租户信息不匹配	不能在其他租户的社区下新增房屋

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api2.hik-cloud.com/api/v1/estate/system/buildings' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{

         
    "unionId": "",

         
    "communityId": "00a795f4a25d4de09edd091f28747eb4",

         
    "buildingName": "1幢",

         
    "buildingNumber": "12",

         
    "floorUpCount": "50",

         
    "floorDownCount": "2",

         
    "floorFamilyCount": "6",

         
    "buildingUnitSize": "10",

         
    "buildingRemark": "备注信息"

         
}'

响应示例

{
    "code": 200,
    "message": "操作成功",
    "data": {
        "buildingId": "6337b1d3721d48e4828fc02ed212e53b"
    }
}

请求参数

Header 参数

Authorization

string

可选

默认值:

Bearer {{access_token}}

Body 参数application/json

unionId

string

关联ID,保留字段

可选

communityId

string

社区ID

必需

buildingName

string

楼栋名称

必需

buildingNumber

string

楼栋编号（1-999之间的整数）

必需

floorUpCount

string

地上楼层数（最多支持100层）

必需

floorDownCount

string

地下楼层数（最多支持3层）

必需

floorFamilyCount

string

每层户数（每层最多支持50户）

必需

buildingUnitSize

string

楼栋单元数量（每栋最多支持30单元）

必需

buildingRemark

string

备注

必需

示例

返回响应

🟢200成功

application/json

Body

code

integer

返回码

必需

message

string

返回消息

必需

data

object

节点对象

必需

buildingId

string

楼栋id

必需

查询社区

删除楼栋