楼盘相关
查询楼盘
请求方式:POST
请求地址:/api/jediopenplatformopenapi/estate/search
请求参数:
| 参数名 | 描述 | 数据类型 | 必填 | 字节长度 |
|---|---|---|---|---|
| startTime | 开始时间 | Date | 是 | 必传, 传入ms时间戳 |
| endTime | 结束时间 | Date | 是 | 必传, 传入ms时间戳 |
请求示例:
{
"page": {
"pageNum": 1,
"pageSize": 20
},
"param": {
"startTime": 1675267200000,
"endTime": 1675353600000
}
}
出参:
| 参数名 | 描述 | 数据类型 | 备注 |
|---|---|---|---|
| estateUuid | 楼盘uuid | String | |
| updatedTime | 更新时间 | Date | |
| createdTime | 创建时间 | Date | |
| deleted | 是否删除 | Boolean | |
| estateName | 楼盘名称 | String | |
| districtUuid | 城区uuid | String | |
| districtName | 城区名称 | String | |
| areaUuid | 商圈uuid | String | |
| areaName | 商圈名称 | String | |
| alias | 别名 | String | |
| usageTypeCfgUuids | 用途uuid列表 | ||
| usageTypeCfgNames | 用途 | Array[string] | |
| fullAddress | 详细地址 | String | |
| managementCompany | 物业公司 | String | |
| managementFee | 物业费 | String | |
| completeYears | 建房年代 | String | |
| developer | 开发商 | String | |
| totalRoomCount | 总户数 | String | |
| totalBuildingCount | 总栋数 | String | |
| schoolNames | 附近学校 | Array[string] | |
| lng | 经度 | Float | |
| lat | 纬度 | Float | |
| ownYears | 产权年限 | String | |
| gasFlag | 是否有燃气 | int | 0: 有燃气; 1: 无燃气 |
| heatingSupply | 是否统一供暖 | int | 0: 是; 1: 否 |
| remark | 备注 | String | |
| estatePhotos | 楼盘图片 | Array[string] | 地址url集合 |
返回示例
{
"responseCode": "1",
"responseMessage": "success",
"responseType": null,
"data": {
"list": [
{
"transactionUuid": "626916a57051479b8867a28e8938c14c",
"txNo": "JY953908209163366",
"txCategoryCode": "txTypeRent",
"txTypeCode": "txTypeRent",
"propertyUuid": "984be1f004d64af98290f14dc28b1a27",
"receiptCategorySettingUuid": "receiptProperty-commissionAmount",
"receivableAchievement": 5000,
"costFee": null,
"returnCommissionAmount": 0,
"platFormFee": 0,
"distributableCommission": 4700,
"distributionRatio": 70,
"distributionAmount": 3290,
"receiptDistributionAmount": 3290,
"distributionStatusCode": "distributionPlanConfirm",
"achievementStatusCode": "achievementInAudit",
"empUuid": "0129bc10-04f4-4370-8bd8-12ff9e5b37a5",
"deptUuid": "99",
"teamAchievementDeptUuid": "99",
"shopManagerUuid": "670a35bd-5bdd-481a-9130-49207de9e37b",
"shopManagerDeptUuid": "99",
"areaManagerUuid": "c326ab48-5631-4c26-81ae-27db058c8e72",
"areaManagerDeptUuid": "99",
"regionalManagerUuid": "e469a4ba-9dfe-4b8c-abeb-bf8478a768c2",
"regionalManagerDeptUuid": "99",
"viceGeneralManagerUuid": "4f566028-80a7-4a00-a055-b13b12ad12ba",
"viceGeneralManagerDeptUuid": "99",
"generalManagerUuid": "5bf22bee-db65-4d45-8e95-5214e92c1f26",
"generalManagerDeptUuid": "99"
},
{
"transactionUuid": "626916a57051479b8867a28e8938c14c",
"txNo": "JY953908209163366",
"txCategoryCode": "txTypeRent",
"txTypeCode": "txTypeRent",
"propertyUuid": "984be1f004d64af98290f14dc28b1a27",
"receiptCategorySettingUuid": "receiptProperty-commissionAmount",
"receivableAchievement": 5000,
"costFee": null,
"returnCommissionAmount": 0,
"platFormFee": 0,
"distributableCommission": 4700,
"distributionRatio": 20,
"distributionAmount": 940,
"receiptDistributionAmount": 940,
"distributionStatusCode": "distributionPlanConfirm",
"achievementStatusCode": "achievementInAudit",
"empUuid": "3e2e698e-4eab-4045-91ca-3331082132c2",
"deptUuid": "99",
"teamAchievementDeptUuid": "99",
"shopManagerUuid": "670a35bd-5bdd-481a-9130-49207de9e37b",
"shopManagerDeptUuid": "99",
"areaManagerUuid": "c326ab48-5631-4c26-81ae-27db058c8e72",
"areaManagerDeptUuid": "99",
"regionalManagerUuid": "e469a4ba-9dfe-4b8c-abeb-bf8478a768c2",
"regionalManagerDeptUuid": "99",
"viceGeneralManagerUuid": "4f566028-80a7-4a00-a055-b13b12ad12ba",
"viceGeneralManagerDeptUuid": "99",
"generalManagerUuid": "5bf22bee-db65-4d45-8e95-5214e92c1f26",
"generalManagerDeptUuid": "99"
}
],
"count": 1508
}
}
2、批量查询二手房楼盘
BASIC
Path: /estate/listEstateByUuids
Method: POST
Desc:
PATH前缀:/api/jediopenplatformopenapi
REQUEST
Query:
| name | value | required | desc |
|---|---|---|---|
| param[0] | YES |
请求示例:
{
"param": [
"0076a80e5c194d849343c7965d56d086",
"00e1f65393f64c6293378c889f6afb29",
"f376b6792fad4fedb2ceb22a4f2607a9"
]
}
RESPONSE
Headers:
| name | value | required | desc |
|---|---|---|---|
| content-type | application/json;charset=UTF-8 | NO |
Body:
| name | type | desc |
|---|---|---|
| responseCode | string | |
| responseMessage | string | |
| responseType | string | |
| errorDataMap | object | |
| |─key | object | |
| data | array | |
| |─ | object | |
| |─estateName | string | 楼盘名称 |
| |─estateUuid | string | 楼盘主键uuid |
| |─alias | string | 别名 |
| |─spell | string | 简拼 |
| |─allSpell | string | 全拼 |
| |─districtUuid | string | 城区uuid |
| |─districtName | string | 城区名 |
| |─areaUuid | string | 商圈uuid |
| |─areaName | string | 商圈名称 |
| |─shortAddress | string | 概要地址 |
| |─fullAddress | string | 详细地址 |
| |─totalRoomCount | integer | 总户数 |
| |─totalPropertyCount | integer | 楼盘下房源个数 |
| |─usageTypeCfgUuids | array | 楼盘用途uuid |
| |─ | string | |
| |─usageTypes | string | 楼盘用途 |
| |─availableUsageTypeCfgUuids | array | 可用用途uuids |
| |─ | string | |
| |─actRoomCount | integer | 实际户数 |
| |─actBuildingCount | integer | 实际栋座数 |
| |─totalBuildingCount | integer | 总栋数 |
| |─lockedEstateFlag | boolean | 楼盘表的锁定字段不建议使用 以后使用新的锁定表(loupan_lock_info)的字段 「已废弃」建议使用新的锁定表loupan_lock_info的字段 「已废弃」 |
| |─lockedBuildingFlag | boolean | 楼盘表的锁定字段不建议使用 以后使用新的锁定表(loupan_lock_info)的字段 「已废弃」建议使用新的锁定表loupan_lock_info的字段 「已废弃」 |
| |─lockedRoomFlag | boolean | 楼盘表的锁定字段不建议使用 以后使用新的锁定表(loupan_lock_info)的字段 「已废弃」建议使用新的锁定表loupan_lock_info的字段 「已废弃」 |
| |─roomRule | integer | 房号规则 「已废弃」建议使用新的锁定表loupan_lock_info的字段 「已废弃」 |
| |─standardEstateUuid | string | 标准楼盘uuid 「已废弃」该字段已废弃 「已废弃」 |
| |─isImport | boolean | 是否导入过 「已废弃」该字段已废弃 「已废弃」 |
| |─importStandardUuid | string | 导入过的楼盘uuid 「已废弃」该字段已废弃 「已废弃」 |
| |─lng | number | 经度 |
| |─lat | number | 纬度 |
| |─standardEstateUuids | array | 关联的标准楼盘Uuid |
| |─ | string | |
| |─standardLockFlag | boolean | 系统认证标记(磐石楼盘字典锁盘标记) |
| |─estateRockName | string | 关联的标准楼盘名称 |
| |─estateRockAddress | string | 关联的标准楼盘地址 |
| |─limitFlag | boolean | 楼盘受限标记,1:N 磐石全部锁定,磐石开关开启时使用 |
| |─multiRelateFlag | boolean | 楼盘 1:N 关联标记,磐石开关开启时使用 |
| |─rockRelateFlag | boolean | 是否与磐石标准楼盘字典已关联 |
| |─estateRockIds | array | 58磐石楼盘字典id集合 |
| |─ | integer | |
| |─structureMode | string | 楼盘结构模式 BUILDING_UNIT_ROOM("buildingUnitRoom","栋-单元-房号"), BUILDING_ROOM("buildingRoom","栋-房号"), UNIT_ROOM("unitRoom","单元-房号"), ESTATE_ROOM("estateRoom","楼盘-房号"); |
| |─limitPropertyCount | integer | 受限制的房源数量 |
| |─crossRockCityId | integer | 58标准磐石城市id的字段(如果该商圈对应的是一个磐石跨城的城市,此字段才会用到) |
| |─isRemoteEstate | boolean | 是否是远程楼盘 |
| |─averageSellUnitPrice | number | 【楼盘售均单价】字段(单位:元/㎡) |
| |─scatteredName | array | 散盘结构名称 |
| |─ | string |
Response Demo:
{
"responseCode": "1",
"responseMessage": "success",
"responseType": null,
"data": [
{
"estateName": "新村路18号",
"estateUuid": "0076a80e5c194d849343c7965d56d086",
"alias": "这个是小区别名",
"spell": "xcl18h",
"allSpell": "xincunlu18hao",
"districtUuid": "c3f26f6d2de8457b861fdfa51812e54a",
"districtName": "普陀区",
"areaUuid": "472869ad7c004bed9ad3b20536ab2b88",
"areaName": "甘泉宜川",
"shortAddress": "这个是概要地址拉",
"fullAddress": "上海市普陀区新村路18号",
"totalRoomCount": 1000,
"totalPropertyCount": 0,
"usageTypeCfgUuids": null,
"usageTypes": null,
"availableUsageTypeCfgUuids": null,
"actRoomCount": 0,
"actBuildingCount": 0,
"totalBuildingCount": 15,
"lockedEstateFlag": false,
"lockedBuildingFlag": false,
"lockedRoomFlag": false,
"roomRule": 3,
"standardEstateUuid": null,
"isImport": null,
"importStandardUuid": null,
"lng": 121.435115,
"lat": 31.272446,
"standardEstateUuids": null,
"standardLockFlag": null,
"estateRockName": null,
"estateRockAddress": null,
"limitFlag": null,
"multiRelateFlag": null,
"rockRelateFlag": null,
"estateRockIds": null,
"structureMode": null,
"limitPropertyCount": null,
"crossRockCityId": null,
"isRemoteEstate": null,
"averageSellUnitPrice": 0.00,
"scatteredName": null,
"remoteEstate": null,
"import": null
},
{
"estateName": "枣阳路853号",
"estateUuid": "00e1f65393f64c6293378c889f6afb29",
"alias": null,
"spell": "zyl853h",
"allSpell": "zaoyanglu853hao",
"districtUuid": "c3f26f6d2de8457b861fdfa51812e54a",
"districtName": "普陀区",
"areaUuid": "6a167cc8723242b880d01756842f2586",
"areaName": "长风",
"shortAddress": null,
"fullAddress": "上海市普陀区枣阳路853号",
"totalRoomCount": null,
"totalPropertyCount": 0,
"usageTypeCfgUuids": null,
"usageTypes": null,
"availableUsageTypeCfgUuids": null,
"actRoomCount": 0,
"actBuildingCount": 0,
"totalBuildingCount": null,
"lockedEstateFlag": false,
"lockedBuildingFlag": false,
"lockedRoomFlag": false,
"roomRule": 3,
"standardEstateUuid": null,
"isImport": null,
"importStandardUuid": null,
"lng": null,
"lat": null,
"standardEstateUuids": null,
"standardLockFlag": null,
"estateRockName": null,
"estateRockAddress": null,
"limitFlag": null,
"multiRelateFlag": null,
"rockRelateFlag": null,
"estateRockIds": null,
"structureMode": null,
"limitPropertyCount": null,
"crossRockCityId": null,
"isRemoteEstate": null,
"averageSellUnitPrice": 0.00,
"scatteredName": null,
"remoteEstate": null,
"import": null
},
{
"estateName": "梅陇三村",
"estateUuid": "f376b6792fad4fedb2ceb22a4f2607a9",
"alias": "jm勿动,梅陇一村,一村的别名呀,梅陇一村45弄,梅陇一村46弄,梅陇三村",
"spell": "mlsc",
"allSpell": "meilongsancun",
"districtUuid": "359e919972f64da5801a5b9edde5e60d",
"districtName": "徐汇区",
"areaUuid": "5093511ea90e4efb9f48c6b953bbc80a",
"areaName": "华东理工",
"shortAddress": "梅陇路555号",
"fullAddress": "上海徐汇梅陇路555号",
"totalRoomCount": 2168,
"totalPropertyCount": 38,
"usageTypeCfgUuids": null,
"usageTypes": null,
"availableUsageTypeCfgUuids": null,
"actRoomCount": 77,
"actBuildingCount": 13,
"totalBuildingCount": 25,
"lockedEstateFlag": true,
"lockedBuildingFlag": true,
"lockedRoomFlag": true,
"roomRule": 3,
"standardEstateUuid": null,
"isImport": null,
"importStandardUuid": null,
"lng": 121.423650,
"lat": 31.142189,
"standardEstateUuids": null,
"standardLockFlag": null,
"estateRockName": null,
"estateRockAddress": null,
"limitFlag": false,
"multiRelateFlag": false,
"rockRelateFlag": null,
"estateRockIds": null,
"structureMode": "unitRoom",
"limitPropertyCount": null,
"crossRockCityId": null,
"isRemoteEstate": null,
"averageSellUnitPrice": 27930.00,
"scatteredName": null,
"remoteEstate": null,
"import": null
}
]
}