外观
修改子项住宅类型
接口概述
批量修改指定项目、专业、子项下的住宅用途与建筑用途,用于校正子项的住宅属性,影响规范条文的适用范围。
请求地址
http
POST /updateResidenceUsage请求头
| 参数 | 必填 | 说明 |
|---|---|---|
| apiKey | 是 | API 访问凭证 |
| Content-Type | 是 | application/json |
请求参数
请求体为子项住宅类型修改项数组:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| projectId | String | 是 | 项目 ID |
| major | Array | 是 | 专业列表,取值参见专业 |
| itemName | String | 是 | 子项名称 |
| buildingEnum | String | 否 | 住宅用途,取值参见住宅用途枚举 |
| structureEnum | String | 否 | 建筑用途,取值参见住宅用途枚举 |
请求示例
bash
curl -X POST "https://openapi.bangtu-ai.com/openApi/updateResidenceUsage" \
-H "apiKey: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"projectId": "1900123456789012345",
"major": ["BUILDING", "STRUCTURE"],
"itemName": "1#楼",
"buildingEnum": "RESIDENCE",
"structureEnum": "RESIDENCE"
}
]'返回结果
json
{
"code": 200,
"message": "success",
"data": null,
"timestamp": 1784533680000
}返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
| code | Number | 通用响应码,200 表示成功 |
| message | String | 响应信息 |
| data | Object | null | 恒为 null |
| timestamp | Number | 服务端响应时间戳,单位为毫秒 |
响应码
| code | 说明 |
|---|---|
| 200 | 请求成功 |
| 500 | 请求失败 |
注意事项
- 本接口仅返回执行结果,不返回业务数据。
major为数组,可一次提交多个专业。