楼盘相关

查询楼盘

请求方式: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
    }
  ]
}

results matching ""

    No results matching ""