6. 业主、房屋、客户相关API
API列表
编号 | API名称 | 路径 | 版本 |
---|---|---|---|
6.1 | 获取当前管家当前项目所管辖的所有业主通讯录 | /imc/owners-address-book/get | 1.0 |
6.2 | 管家获取某一个客户的房屋信息 | /imc/owners-address-book/house-info | 1.0 |
6.3 | 云邻管家获取当前房屋的状态变更信息 | /mid/space/query/house-record/by-house | 1.0 |
6.5 | 云邻管家查询获取客户数据 | /mid/cust/house-keeper/query/cust | 1.0 |
6.6 | 云邻管家分页获取客户备注信息 | /mid/cust/cust-remark-info/list | 1.0 |
6.7 | 云邻管家添加客户备注信息 | /mid/cust/cust-remark-info/create | 1.0 |
6.8 | 云邻管家删除客户备注信息 | /mid/cust/cust-remark-info/delete | 1.0 |
6.9 | 云邻管家更新客户备注名信息 | /mid/cust/update/info | 1.0 |
6.10 | 云邻管家根据业主获取业主名下的车位信息 | /mid/cust/cust-remark-info/delete | 1.0 |
6.11 | 云邻管家根据业主获取业主名下的车牌信息 | /mid/cust/update/info | 1.0 |
6.12 | 云邻管家一户一档楼栋信息 | /mid/space/query/one-file-per/build | 1.0 |
6.13 | 云邻管家一户一档房屋信息 | /mid/space/query/one-file-per/house | 1.0 |
API调用
6.1: 获取当前管家当前项目所管辖的所有业主通讯录
描述
请求信息
HTTP协议:HTTP,HTTPS
uri:/imc/owners-address-book/get
方法:POST
请求参数
名称 | 位置 | 类型 | 必填 | 描述 |
---|---|---|---|---|
communityId | BODY | Integer | 是 | 项目ID: |
userName | BODY | STRING | 是 | 管家账号:userName |
queryStr | BODY | STRING | 否 | 搜索参数:业主姓名,房号,电话号码的模糊匹配 |
pageNo | BODY | Integer | 是 | 页码 |
pageSize | BODY | Integer | 是 | 分页数 |
请求Body描述(非Form表单数据)
{
"communityId":"21291194",
"userName":"hewx6",
"pageNo":1,
"pageSize":10
}
返回信息
返回参数类型
JSON
返回参数
名称 | 位置 | 类型 | 必填 | 描述 |
---|---|---|---|---|
code | 顶层 | STRING | 是 | 响应码标识 |
message | 顶层 | STRING | 是 | 响应消息文本 |
data | 顶层 | JSONObject | 是 | 响应数据对象 |
total | data | INTEGER | 是 | 总记录数 |
pages | data | INTEGER | 是 | 页数 |
records | data | JSONArray | 是 | 参数信息 |
resourceName | records | String | 是 | APP显示的名称 |
houseName | records | String | 是 | 房屋名称 |
houseId | records | Integer | 是 | 房屋Id |
profilePhoto | records | String | 否 | 客户头像 |
custName | records | String | 是 | 客户名称 |
custId | records | Integer | 是 | 客户Id |
custType | records | String | 是 | 业主类型 --"业主":1000;"业主成员":1001;"租户":2000;"租户成员":2001;"访客":4000; |
communityName | records | String | 是 | 项目名称,要和APP显示名称一起展示在APP端 |
communityId | records | Integer | 是 | 项目Id |
custPhone | records | String | 是 | 客户手机号 |
custStatus | records | String | 是 | 客户状态,0标示不能出现那个聊天的标示 |
返回结果示例
{
"code": 200,
"data": {
"total": 134,
"pages": 14,
"records": [
{
"houseId": 35000116,
"resourceName": "1栋 1单元 501",
"custName": "15618341521",
"custId": "234567",
"custPhone": "15618341521",
"houseName": "1栋_1单元_501",
"custType": 1000,
"communityName": "佛山美的广场",
"communityId": 21291194,
"custStatus": 0
}
],
"pageNo": 1,
"pageSize": 10
},
"message": "success"
}
异常返回示例
{"code":"1301","message":""}
6.2: 管家获取某一个客户的房屋信息
描述
请求信息
HTTP协议:HTTP,HTTPS
uri:/imc/owners-address-book/house-info
方法:POST
请求参数
名称 | 位置 | 类型 | 必填 | 描述 |
---|---|---|---|---|
houseId | BODY | Integer | 是 | 房屋ID |
communityId | BODY | Integer | 是 | 项目ID |
userName | BODY | String | 否 | 管家账号userName |
请求Body描述(非Form表单数据)
{
"communityId":"21291194",
"userName":"hewx6",
"houseId":35000229
}
返回信息
名称 | 位置 | 类型 | 必填 | 描述 |
---|---|---|---|---|
code | 顶层 | STRING | 是 | 响应码标识 |
message | 顶层 | STRING | 是 | 响应消息文本 |
data | 顶层 | JSONObject | 是 | 响应数据对象 |
inTime | data | String | 是 | 房屋入住时间 |
joinTime | data | String | 是 | 房屋入伙时间 |
houseName | data | String | 是 | 房屋名称 |
resTypeStr | data | String | 是 | 房屋用途类型名称 |
addressBook | data | JSONArray | 是 | 房屋下的成员信息 |
buildName | addressBook | String | 是 | 楼栋名称 |
unitName | addressBook | String | 是 | 单元名称 |
joinTime | addressBook | String | 是 | 入伙时间 |
sex | addressBook | String | 是 | 性别(0未设置,1女,2男) |
profilePhoto | addressBook | String | 否 | 客户头像 |
resourceName | addressBook | String | 是 | APP显示的名称 |
levelName | addressBook | String | 是 | 客户级别名称 |
custName | addressBook | String | 是 | 客户名称 |
resTypeStr | addressBook | String | 是 | 房屋用途名称 |
communityName | addressBook | String | 是 | 项目名称,要和APP显示名称一起展示在APP端 |
custPhone | addressBook | String | 是 | 客户手机号 |
custStatus | addressBook | String | 是 | 客户状态,0标示不能出现那个聊天的标示 |
返回结果示例
{
"code": 200,
"data": {
"inTime": null,
"houseName": "佛山美的广场1栋_1单元_701",
"joinTime": "2021-01-11",
"addressBook": [
{
"buildName": "1栋",
"houseId": 35000229,
"unitName": "1单元",
"joinTime": "2021-01-11",
"resType": 0,
"sex": 2,
"resourceName": "1栋 1单元 701",
"buildId": 50094113,
"levelName": "一般客户",
"custName": "彬彬",
"custPhone": "18666007698",
"custLevel": "1",
"resTypeStr": "自住",
"houseName": "1栋_1单元_701",
"areaId": 1171999,
"custType": 1001,
"custTypeName": "业主成员",
"unitId": 50094114,
"communityName": "佛山美的广场",
"communityId": 21291194,
"custStatus": 0
},
{
"buildName": "1栋",
"houseId": 35000229,
"unitName": "1单元",
"joinTime": "2016-12-17",
"resType": 0,
"resourceName": "1栋 1单元 701",
"buildId": 50094113,
"levelName": "一般客户",
"custName": "梁淑钏",
"custPhone": "15815615243",
"custLevel": "1",
"resTypeStr": "自住",
"houseName": "1栋_1单元_701",
"areaId": 1171999,
"custType": 1001,
"custTypeName": "业主成员",
"unitId": 50094114,
"communityName": "佛山美的广场",
"communityId": 21291194,
"custStatus": 0
},
{
"buildName": "1栋",
"houseId": 35000229,
"unitName": "1单元",
"joinTime": "2016-12-17",
"resType": 0,
"resourceName": "1栋 1单元 701",
"buildId": 50094113,
"levelName": "一般客户",
"custName": "梁伟堂",
"custPhone": "13823400127",
"custLevel": "1",
"resTypeStr": "自住",
"houseName": "1栋_1单元_701",
"areaId": 1171999,
"custType": 1000,
"custTypeName": "业主",
"unitId": 50094114,
"communityName": "佛山美的广场",
"communityId": 21291194,
"custStatus": 0
}
],
"resTypeStr": "自住"
},
"message": "success"
}
6.3: 云邻管家获取当前房屋的状态变更信息
描述
请求信息
HTTP协议:HTTP,HTTPS
uri:/mid/space/query/house-record/by-house
方法:POST
请求参数
名称 | 位置 | 类型 | 必填 | 描述 |
---|---|---|---|---|
houseId | BODY | Integer | 是 | 房屋ID |
communityId | BODY | Integer | 是 | 项目ID |
pageNo | BODY | Integer | 是 | 页码 |
pageSize | BODY | Integer | 是 | 分页数 |
请求Body描述(非Form表单数据)
{
"communityId":"21291194",
"houseId":35281627,
"pageNo":1,
"pageSize":10
}
返回信息
名称 | 位置 | 类型 | 必填 | 描述 |
---|---|---|---|---|
code | 顶层 | STRING | 是 | 响应码标识 |
message | 顶层 | STRING | 是 | 响应消息文本 |
data | 顶层 | JSONObject | 是 | 响应数据对象 |
total | data | INTEGER | 是 | 总记录数 |
pages | data | INTEGER | 是 | 页数 |
records | data | JSONArray | 是 | 房屋状态变更信息 |
houseRecordId | records | String | 是 | 变更记录ID |
houseId | records | String | 是 | 房间ID |
crtTime | records | String | 是 | 创建时间 |
lastHouseStatusStr | records | String | 是 | 上次状态描述 |
currHouseStatusStr | records | String | 是 | 当前状态描述 |
sourceStr | records | String | 是 | 来源 |
operatorName | records | String | 是 | 操作人 |
返回参数类型
JSON
返回结果示例
{
"code": 200,
"data": {
"total": 1,
"pages": 1,
"records": [
{
"houseRecordId": 1248485,
"houseId": 35281627,
"lastHouseStatus": null,
"currHouseStatus": "5090",
"lastStatusType": null,
"currStatusType": "9999",
"remark": null,
"crtTime": "2019-01-24 01:03:44",
"operator": 1916098,
"source": 0,
"lastHouseStatusStr": "",
"currHouseStatusStr": "已收楼已装修未入住",
"lastStatusTypeStr": null,
"currStatusTypeStr": null,
"sourceStr": "未登记",
"operatorName": "黎改英"
}
],
"pageNo": 1,
"pageSize": 10
},
"message": "success"
}
6.5: 云邻管家查询获取客户数据
描述 云邻管家查询获取客户数据
请求信息
HTTP协议:HTTP,HTTPS
uri:/mid/cust/house-keeper/query/cust
方法:POST
请求参数
名称 | 位置 | 类型 | 必填 | 描述 |
---|---|---|---|---|
custId | BODY | Integer | 是 | 客户ID |
请求Body描述(非Form表单数据)
{
"custId":"46875279"
}
返回信息
名称 | 位置 | 类型 | 必填 | 描述 |
---|---|---|---|---|
code | 顶层 | STRING | 是 | 响应码标识 |
message | 顶层 | STRING | 是 | 响应消息文本 |
data | 顶层 | JSONObject | 是 | 响应数据对象 |
houses | data | JSONArray | 是 | 返回的是查询客户当前名下的房屋信息 |
communityName | houses | String | 是 | 项目名称 |
name | houses | String | 是 | 房屋名称 |
totalOwesFee | houses | BigDecimal | 是 | 房屋总欠费金额 |
customer | data | JSONArray | 是 | 返回的是查询客户信息 |
sex | customer | String | 是 | 性别(0未设置,1女,2男) |
custId | customer | String | 是 | 客户Id |
communityName | customer | String | 是 | 项目名称 |
custLevelName | customer | String | 是 | 客户级别名称 |
profilePhoto | customer | String | 否 | 客户头像 |
communityId | customer | String | 是 | 项目ID |
custLevel | customer | String | 是 | 客户级别 |
custName | customer | String | 是 | 客户名称 |
custPhone | customer | String | 是 | 客户电话 |
maritalStatus | customer | String | 是 | 婚姻状态:0:未知,1:已婚,2:未婚,3:离异 |
custStatus | customer | String | 是 | 房屋名称 |
remarkName | customer | String | 否 | 客户备注信息,如果存在需要按样式展示 |
birthday | customer | String | 否 | 生日 |
householdsAddr | customer | String | 否 | 户口所在地 |
nativePlace | customer | String | 否 | 籍贯 |
qualification | customer | String | 否 | 学历 |
politicalStatus | customer | String | 否 | 政治面貌 |
返回参数类型
JSON
返回结果示例
{
"code": 200,
"data": {
"houses": [
{
"houseId": 35569999,
"roomNo": "101",
"buildId": 50371713,
"updateTime": 1564816697000,
"floorId": 50372108,
"unit": null,
"createTime": 1564125182000,
"name": "2栋_101",
"custType": "1000",
"unitId": null,
"communityName": "岳阳美的梧桐庄园",
"floor": null,
"communityId": 21321217,
"status": 1,
"custStatus": "1000"
}
],
"customer": {
"sex": 1,
"custId": 46875279,
"custType": 1000,
"custTypeName": "业主",
"communityName": "岳阳美的梧桐庄园",
"custLevelName": "一般客户",
"communityId": 21321217,
"custLevel": "1",
"custName": "15618341521",
"custPhone": "15618341521",
"maritalStatus": 0,
"custStatus": 1
}
},
"message": "success"
}
6.6: 云邻管家分页获取客户备注信息
描述 云邻管家分页获取客户备注信息
请求信息
HTTP协议:HTTP,HTTPS
uri:/mid/cust/cust-remark-info/list
方法:POST
请求参数
名称 | 位置 | 类型 | 必填 | 描述 |
---|---|---|---|---|
custId | body | Integer | 是 | 客户ID |
pageNo | body | Integer | 是 | 页码 |
pageSize | body | Integer | 是 | 分页数 |
请求Body描述(非Form表单数据)
{
"custId": 46875279,
"pageNo":1,
"pageSize":10
}
返回信息
名称 | 位置 | 类型 | 必填 | 描述 |
---|---|---|---|---|
code | 顶层 | STRING | 是 | 响应码标识 |
message | 顶层 | STRING | 是 | 响应消息文本 |
data | 顶层 | JSONObject | 是 | 响应数据对象 |
total | data | INTEGER | 是 | 总记录数 |
pages | data | INTEGER | 是 | 页数 |
records | data | JSONArray | 是 | 客户备注信息 |
remarkInfoId | records | Integer | 是 | 客户备注记录ID |
custId | records | Integer | 是 | 客户ID |
remark | records | String | 是 | 备注信息 |
createTime | records | DATE | 是 | 创建时间 |
createName | records | String | 是 | 操作人名称 |
返回参数类型
JSON
返回结果示例
{
"code": 200,
"data": {
"total": 6,
"pages": 1,
"records": [
{
"remarkInfoId": 2,
"custId": 46875279,
"remark": "世界上最遥远的距离是地球与地球的距离",
"createTime": "2021-07-21 05:56:22",
"updateTime": "2021-07-21 05:56:22",
"createBy": 1915492,
"updateBy": 1915492,
"createName": "何伟贤"
},
{
"remarkInfoId": 3,
"custId": 46875279,
"remark": "种下梧桐,凤凰自来,你若盛开,蝴蝶自来!",
"createTime": "2021-07-21 06:01:19",
"updateTime": "2021-07-21 06:01:19",
"createBy": 124923,
"updateBy": 124923,
"createName": "贾怡多"
},
{
"remarkInfoId": 4,
"custId": 46875279,
"remark": "万物皆可早教!!!!",
"createTime": "2021-07-21 06:01:58",
"updateTime": "2021-07-21 06:01:58",
"createBy": 129459,
"updateBy": 129459,
"createName": "李鑫"
},
{
"remarkInfoId": 5,
"custId": 46875279,
"remark": "色彩敏感期,行走敏感期,音乐敏感期!!!!",
"createTime": "2021-07-21 06:02:44",
"updateTime": "2021-07-21 06:02:44",
"createBy": 131942,
"updateBy": 131942,
"createName": "靖雨蒙"
},
{
"remarkInfoId": 7,
"custId": 46875279,
"remark": "兴趣是一切最开始的源头!!!!",
"createTime": "2021-07-21 06:05:22",
"updateTime": "2021-07-21 06:05:22",
"createBy": 590919,
"updateBy": 590919,
"createName": "杨刚"
},
{
"remarkInfoId": 8,
"custId": 46875279,
"remark": "兴趣是一切最开始的源头!!!!",
"createTime": "2021-07-21 06:05:24",
"updateTime": "2021-07-21 06:05:24",
"createBy": 590919,
"updateBy": 590919,
"createName": "杨刚"
}
],
"pageNo": 1,
"pageSize": 10
},
"message": "success"
}
6.7: 云邻管家添加客户备注信息
描述 云邻管家添加客户备注信息
请求信息
HTTP协议:HTTP,HTTPS
uri:/mid/cust/cust-remark-info/create
方法:POST
请求参数
名称 | 位置 | 类型 | 必填 | 描述 |
---|---|---|---|---|
custId | BODY | Integer | 是 | 客户ID |
userId | BODY | Integer | 是 | 管家登录的用户ID |
remark | BODY | String | 是 | 用户备注信息 |
请求Body描述(非Form表单数据)
{
"custId":"46875279",
"userId":"1915492",
"remark":"世界上最遥远的距离是地球与地球的距离"
}
返回信息
名称 | 位置 | 类型 | 必填 | 描述 |
---|---|---|---|---|
code | 顶层 | STRING | 是 | 响应码标识 |
message | 顶层 | STRING | 是 | 响应消息文本 |
data | 顶层 | JSONObject | 是 | 响应数据对象 |
返回参数类型
JSON
返回结果示例
返回结果情况一:
{
"code": 20002,
"data": {},
"message": "添加失败"
}
返回结果情况二:
{
"code": 200,
"data": {},
"message": "成功"
}
6.8: 删除客户备注记录信息
描述
请求信息
HTTP协议:HTTP,HTTPS
uri:/mid/cust/cust-remark-info/delete
方法:POST
请求参数
名称 | 位置 | 类型 | 必填 | 描述 |
---|---|---|---|---|
remarkInfoId | Body | Integer | 是 | 要删除的客户备注记录ID |
请求Body描述(非Form表单数据)
{
"remarkInfoId":6
}
返回信息
名称 | 位置 | 类型 | 必填 | 描述 |
---|---|---|---|---|
code | 顶层 | STRING | 是 | 响应码标识 |
message | 顶层 | STRING | 是 | 响应消息文本 |
data | 顶层 | JSONObject | 是 | 响应数据对象 |
返回参数类型
JSON
返回结果示例
{
"code": 200,
"data": {},
"message": "成功"
}
6.9: 云邻管家更新客户备注名信息
描述
请求信息
HTTP协议:HTTP,HTTPS
uri:/mid/cust/update/info
方法:POST
请求参数
名称 | 位置 | 类型 | 必填 | 描述 |
---|---|---|---|---|
custId | BODY | Integer | 是 | 要添加备注名的客户ID |
remarkName | BODY | String | 是 | 备注名 |
请求Body描述(非Form表单数据)
{
"custId": 46875279,
"remarkName":"幸福的小孩"
}
返回信息
名称 | 位置 | 类型 | 必填 | 描述 |
---|---|---|---|---|
code | 顶层 | STRING | 是 | 响应码标识 |
message | 顶层 | STRING | 是 | 响应消息文本 |
data | 顶层 | JSONObject | 是 | 响应数据对象 |
返回参数类型
JSON
返回结果示例
{
"code": 200,
"data": {},
"message": "success"
}
6.10: 云邻管家根据业主获取业主名下的车位信息
描述
请求信息
HTTP协议:HTTP,HTTPS
uri:https://iot-api-uat.smartmideazy.com/v2/smart-parkinglot/xlink-park/car-place
方法:GET
请求参数
名称 | 位置 | 类型 | 必填 | 描述 |
---|---|---|---|---|
data | HEADER | JSONObject | 是 | 要查询的信息 |
请求Body描述(非Form表单数据)
data: {
"limit":999,
"offset":0,
"query":{
"project_id":{
"$eq":"21441118" //项目ID
},
"owner_list.owner_id":{
"$in":[
"46832655" //客户的记录ID,即custId
]
}
}
}
返回信息
名称 | 位置 | 类型 | 必填 | 描述 |
---|---|---|---|---|
code | 顶层 | STRING | 是 | 响应码标识 |
message | 顶层 | STRING | 是 | 响应消息文本 |
data | 顶层 | JSONObject | 是 | 响应数据对象 |
list | data | JSONArray | 是 | 车辆信息列表 |
parking_space_no | list | String | 是 | 车位号 |
parking_space_name | list | String | 是 | 车位名称 |
project_name | list | String | 是 | 项目名称 |
返回参数类型
JSON
返回结果示例
{
"code":"000000",
"msg":"请求成功",
"data":{
"list":[
{
"area_id":"50410769",
"area_name":"地下停车场",
"parking_space_no":"YGG-DR-0108",
"parking_space_name":"领贤体验馆地下车场人防小车0108",
"parking_space_position":"地下停车场",
"parking_space_classify":2,
"parking_space_sales_status":4,
"id":"50411408",
"project_id":"21441118",
"project_name":"领贤体验馆02",
"parkinglot_id":"e7b43b0f882325ef8f7c2ea22387d164",
"parkinglot_no":"112233",
"parkinglot_name":"领贤02",
"create_date":"2020-03-09T16:11:08.856Z",
"update_date":"2020-10-16T07:30:58.842Z",
"deleted":false,
"create_by":"系统",
"update_by":"系统",
}
],
"count":1
},
"status":200
}
6.11: 云邻管家根据业主获取业主名下的车牌信息
描述
请求信息
HTTP协议:HTTP,HTTPS
uri:https://iot-api-uat.smartmideazy.com/v2/smart-parkinglot/xlink-carowner/owner-info/car-info
方法:GET
请求参数
名称 | 位置 | 类型 | 必填 | 描述 |
---|---|---|---|---|
data | HEADER | JSONObject | 是 | 要查询的信息 |
请求Body描述(非Form表单数据)
data: {
"filter":[
"id",
"owner_id",
"car_plate_no",
"car_brand",
"carowner_name",
"driving_license_no",
"license_pic_front",
"license_pic_back"
],
"offset":0,
"limit":999,
"query":{
"project_id":{
"$eq":"21441118" //项目ID
},
"owner_id":{
"$eq":"46832666" //客户ID
}
}
}
返回信息
名称 | 位置 | 类型 | 必填 | 描述 |
---|---|---|---|---|
code | 顶层 | STRING | 是 | 响应码标识 |
message | 顶层 | STRING | 是 | 响应消息文本 |
data | 顶层 | JSONObject | 是 | 响应数据对象 |
list | data | JSONArray | 是 | 车辆信息列表 |
car_plate_no | list | String | 是 | 车牌号 |
返回参数类型
JSON
返回结果示例
{
"code":"000000",
"msg":"请求成功",
"data":{
"list":[
{
"id":"bacaddc2cc960898ec07b58145e5bc63",
"owner_id":"46832666",
"license_pic_front":"http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/profilephoto/1591110269966.jpg",
"car_plate_no":"京KH2844",
"carowner_name":"邵光远"
},
{
"id":"40bccd7486c81587e0b19803c9e045dc",
"owner_id":"46832666",
"license_pic_front":"http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/profilephoto/1591110373420.jpg",
"car_plate_no":"粤A2722港"
}
],
"count":2
},
"status":200
}
注意注意:后面两个接口是车场的接口,直接拿过来用
6.12: 云邻管家一户一档楼栋信息
描述
请求信息
HTTP协议:HTTP,HTTPS
uri:https://smart-assistant-uat.smartmideazy.com/mid/space/query/one-file-per/build
方法:POST
请求参数
名称 | 位置 | 类型 | 必填 | 描述 |
---|---|---|---|---|
areaId | BODY | Integer | 是 | 要添加备注名的客户ID |
communityId | BODY | Integer | 是 | 项目ID |
请求Body描述(非Form表单数据)
{
"areaId":"1212008",
"communityId":"1003837"
}
返回信息
名称 | 位置 | 类型 | 必填 | 描述 |
---|---|---|---|---|
code | 顶层 | STRING | 是 | 响应码标识 |
message | 顶层 | STRING | 是 | 响应消息文本 |
data | 顶层 | JSONArray | 是 | 响应数据对象 |
name | data | data | 是 | 楼栋名称 |
buildId | data | data | 是 | 楼栋ID |
communityName | data | String | 是 | 项目名称 |
communityId | data | Integer | 是 | 项目ID |
units | data | JSONArray | 是 | 楼栋里的单元数组 |
unitName | units | String | 是 | 单元名称 |
unitId | units | Integer | 是 | 单元ID |
buildId | units | Integer | 是 | 楼栋ID |
communityId | units | Integer | 是 | 项目ID |
返回参数类型
JSON
返回结果示例
{
"code": 200,
"data": [
{
"name": "9栋",
"buildId": 101879,
"communityName": "佛山美的翰诚嘉园",
"units": [
{
"unitName": "1单元",
"unitId": 101881,
"buildId": 101879,
"communityId": 1003837
}
],
"communityId": 1003837
},
{
"name": "10栋",
"buildId": 109627,
"communityName": "佛山美的翰诚嘉园",
"units": [
{
"unitName": "1单元",
"unitId": 109628,
"buildId": 109627,
"communityId": 1003837
}
],
"communityId": 1003837
},
{
"name": "11栋",
"buildId": 109633,
"communityName": "佛山美的翰诚嘉园",
"units": [
{
"unitName": "1单元",
"unitId": 110343,
"buildId": 109633,
"communityId": 1003837
}
],
"communityId": 1003837
},
{
"name": "12栋",
"buildId": 109634,
"communityName": "佛山美的翰诚嘉园",
"units": [
{
"unitName": "1单元",
"unitId": 110344,
"buildId": 109634,
"communityId": 1003837
}
],
"communityId": 1003837
},
{
"name": "13栋",
"buildId": 247407,
"communityName": "佛山美的翰诚嘉园",
"units": [
{
"unitName": "1单元",
"unitId": 247408,
"buildId": 247407,
"communityId": 1003837
}
],
"communityId": 1003837
},
{
"name": "14栋",
"buildId": 247409,
"communityName": "佛山美的翰诚嘉园",
"units": [
{
"unitName": "1单元",
"unitId": 247410,
"buildId": 247409,
"communityId": 1003837
}
],
"communityId": 1003837
}
],
"message": "success"
}
6.13: 一户一档获取房屋信息
一户一档获取房屋信息
请求信息
HTTP协议:HTTP,HTTPS
uri:https://smart-assistant-uat.smartmideazy.com/mid/space/query/one-file-per/house
方法:POST
请求参数
名称 | 位置 | 类型 | 必填 | 描述 |
---|---|---|---|---|
buildId | BODY | Integer | 是 | 楼栋ID |
unitId | BODY | Integer | 是 | 单元ID |
communityId | BODY | Integer | 是 | 项目ID |
buyStatus | BODY | Integer | 是 | 房屋售卖状态:1【未售】,2【已售未收】,3【已售已收】 |
houStatus | BODY | Integer | 是 | 房屋状态:1【空置】,2【装修中】,3【已入住】 |
请求Body描述(非Form表单数据)
{
"communityId":"1003837",
"buildId":"101879",
"unitId":"101881"
}
返回信息
名称 | 位置 | 类型 | 必填 | 描述 |
---|---|---|---|---|
code | 顶层 | STRING | 是 | 响应码标识 |
message | 顶层 | STRING | 是 | 响应消息文本 |
data | 顶层 | JSONObject | 是 | 响应数据对象 |
yswsNum | data | Bigdecimal | 是 | 已售未收数量 |
wsNum | data | Bigdecimal | 是 | 未售数量 |
zxzNum | data | Bigdecimal | 是 | 装修中数量 |
kzNum | data | Bigdecimal | 是 | 空置数量 |
yrznum | data | Bigdecimal | 是 | 已入住数量 |
ysysNum | data | Bigdecimal | 是 | 已售已收数量 |
floorList | data | JSONArray | 是 | 楼层数组 |
floorNo | floorList | String | 是 | 楼层,几楼几楼 |
houses | floorList | JSONArray | 是 | 楼层中的房屋 |
totalOwesFee | houses | BigDecimal | 是 | 欠费金额 |
houseId | houses | Integer | 是 | 房屋ID |
roomNo | houses | String | 是 | 房间号 |
houseStatus | houses | String | 是 | 房间状态: 5001 未售空置 ; 5040 已售空置已到收楼日期 5030 已售空置未到收楼日期;5050 已收楼未入住未装修;5060 已收楼未入住装修申请;5070 已收楼未入住装修验收;5090 已收楼已装修未入住;5080 已收楼已入住业主;5100 已收楼已入住租户;5140 未售车位未出租;5170 未售车位已出租;未售 5001,已售未收 5030,;已售已收 5040,5050,5060,5070,5080,5090,5100 空置 5001,5040,5030 ;装修中 5060 ; 已入住 5080,5100 ; |
floorNo | houses | String | 是 | 房间所处楼层 |
buildId | houses | Integer | 是 | 楼栋ID |
communityId | houses | Integer | 是 | 项目ID |
返回参数类型
JSON
返回结果示例
{{
"code": 200,
"data": {
"yswsNum": 0,
"floorList": [
{
"houses": [
{
"totalOwesFee": 0,
"houseId": 1222868,
"roomNo": "201",
"houseStatus": 5080,
"unitId": 101881,
"floorNo": "2",
"buildId": 101879,
"communityId": 1003837
},
{
"totalOwesFee": 0,
"houseId": 1222869,
"roomNo": "202",
"houseStatus": 5080,
"unitId": 101881,
"floorNo": "2",
"buildId": 101879,
"communityId": 1003837
},
{
"totalOwesFee": 0,
"houseId": 1222870,
"roomNo": "203",
"houseStatus": 5080,
"unitId": 101881,
"floorNo": "2",
"buildId": 101879,
"communityId": 1003837
},
{
"totalOwesFee": 0,
"houseId": 1222871,
"roomNo": "204",
"houseStatus": 5080,
"unitId": 101881,
"floorNo": "2",
"buildId": 101879,
"communityId": 1003837
}
],
"floorNo": "2"
},
{
"houses": [
{
"totalOwesFee": 0,
"houseId": 1222872,
"roomNo": "301",
"houseStatus": 5080,
"unitId": 101881,
"floorNo": "3",
"buildId": 101879,
"communityId": 1003837
},
{
"totalOwesFee": 0,
"houseId": 1222873,
"roomNo": "302",
"houseStatus": 5080,
"unitId": 101881,
"floorNo": "3",
"buildId": 101879,
"communityId": 1003837
},
{
"totalOwesFee": 0,
"houseId": 1222874,
"roomNo": "303",
"houseStatus": 5080,
"unitId": 101881,
"floorNo": "3",
"buildId": 101879,
"communityId": 1003837
},
{
"totalOwesFee": 0,
"houseId": 1222875,
"roomNo": "304",
"houseStatus": 5080,
"unitId": 101881,
"floorNo": "3",
"buildId": 101879,
"communityId": 1003837
}
],
"floorNo": "3"
},
{
"houses": [
{
"totalOwesFee": 0,
"houseId": 1222876,
"roomNo": "401",
"houseStatus": 5080,
"unitId": 101881,
"floorNo": "4",
"buildId": 101879,
"communityId": 1003837
},
{
"totalOwesFee": 0,
"houseId": 1222877,
"roomNo": "402",
"houseStatus": 5050,
"unitId": 101881,
"floorNo": "4",
"buildId": 101879,
"communityId": 1003837
},
{
"totalOwesFee": 0,
"houseId": 1222878,
"roomNo": "403",
"houseStatus": 5080,
"unitId": 101881,
"floorNo": "4",
"buildId": 101879,
"communityId": 1003837
},
{
"totalOwesFee": 0,
"houseId": 1222879,
"roomNo": "404",
"houseStatus": 5080,
"unitId": 101881,
"floorNo": "4",
"buildId": 101879,
"communityId": 1003837
}
],
"floorNo": "4"
},
{
"houses": [
{
"totalOwesFee": 0,
"houseId": 1222880,
"roomNo": "501",
"houseStatus": 5050,
"unitId": 101881,
"floorNo": "5",
"buildId": 101879,
"communityId": 1003837
},
{
"totalOwesFee": 0,
"houseId": 1222881,
"roomNo": "502",
"houseStatus": 5080,
"unitId": 101881,
"floorNo": "5",
"buildId": 101879,
"communityId": 1003837
},
{
"totalOwesFee": 0,
"houseId": 1222882,
"roomNo": "503",
"houseStatus": 5080,
"unitId": 101881,
"floorNo": "5",
"buildId": 101879,
"communityId": 1003837
},
{
"totalOwesFee": 0,
"houseId": 1222883,
"roomNo": "504",
"houseStatus": 5050,
"unitId": 101881,
"floorNo": "5",
"buildId": 101879,
"communityId": 1003837
}
],
"floorNo": "5"
},
{
"houses": [
{
"totalOwesFee": 0,
"houseId": 1222884,
"roomNo": "601",
"houseStatus": 5080,
"unitId": 101881,
"floorNo": "6",
"buildId": 101879,
"communityId": 1003837
},
{
"totalOwesFee": 0,
"houseId": 1222885,
"roomNo": "602",
"houseStatus": 5080,
"unitId": 101881,
"floorNo": "6",
"buildId": 101879,
"communityId": 1003837
},
{
"totalOwesFee": 0,
"houseId": 1222886,
"roomNo": "603",
"houseStatus": 5080,
"unitId": 101881,
"floorNo": "6",
"buildId": 101879,
"communityId": 1003837
},
{
"totalOwesFee": 0,
"houseId": 1222887,
"roomNo": "604",
"houseStatus": 5080,
"unitId": 101881,
"floorNo": "6",
"buildId": 101879,
"communityId": 1003837
}
],
"floorNo": "6"
},
{
"houses": [
{
"totalOwesFee": 0,
"houseId": 1222888,
"roomNo": "701",
"houseStatus": 5080,
"unitId": 101881,
"floorNo": "7",
"buildId": 101879,
"communityId": 1003837
},
{
"totalOwesFee": 0,
"houseId": 1222889,
"roomNo": "702",
"houseStatus": 5080,
"unitId": 101881,
"floorNo": "7",
"buildId": 101879,
"communityId": 1003837
},
{
"totalOwesFee": 0,
"houseId": 1222890,
"roomNo": "703",
"houseStatus": 5080,
"unitId": 101881,
"floorNo": "7",
"buildId": 101879,
"communityId": 1003837
},
{
"totalOwesFee": 0,
"houseId": 1222891,
"roomNo": "704",
"houseStatus": 5080,
"unitId": 101881,
"floorNo": "7",
"buildId": 101879,
"communityId": 1003837
}
],
"floorNo": "7"
},
{
"houses": [
{
"totalOwesFee": 0,
"houseId": 1222892,
"roomNo": "801",
"houseStatus": 5080,
"unitId": 101881,
"floorNo": "8",
"buildId": 101879,
"communityId": 1003837
},
{
"totalOwesFee": 0,
"houseId": 1222893,
"roomNo": "802",
"houseStatus": 5050,
"unitId": 101881,
"floorNo": "8",
"buildId": 101879,
"communityId": 1003837
},
{
"totalOwesFee": 0,
"houseId": 1222894,
"roomNo": "803",
"houseStatus": 5080,
"unitId": 101881,
"floorNo": "8",
"buildId": 101879,
"communityId": 1003837
},
{
"totalOwesFee": 0,
"houseId": 1222895,
"roomNo": "804",
"houseStatus": 5080,
"unitId": 101881,
"floorNo": "8",
"buildId": 101879,
"communityId": 1003837
}
],
"floorNo": "8"
}
],
"wsNum": 0,
"zxzNum": 0,
"kzNum": 0,
"yrzNum": 0,
"ysysNum": 100
},
"message": "success"
}