查询全部员工

请求方式：POST

请求地址：/api/marketingopenapi/employee/listEmployeeByUuids

  • 根据uuids查询员工信息
  • 这里的uuid都是从营销库获得, 与sass系统不是同一个uuid，【人事】分类下接口的员工UUID入参需使用externalEmployeeUuid

请求参数：

参数 描述 数据类型 必填 字段长度
employeeUuids 营销员工UUID集合 List<String> 是  

请求示例：

{
  "employeeUuids": [
    "3792eb45-3848-42d7-bb33-0b4dbc14bc69",
    "da13bf5c-55ad-4255-a535-0fd6a2a8a50c"
  ]
}

返回参数：

参数 数据类型 描述
name String 员工姓名
gender String 性别
cellphone String 手机
photoUrl String 头像
employeeUuid String 员工Uuid
employeeNo String 员工编号
updatedTime Date 更新时间
companyUuid String 营销公司uuid
externalCompanyUuid String SaaS公司uuid
externalEmployeeUuid String SaaS公司员工uuid, 可用于调用【人事】分类下员工uuid的入参(仅V20可用)

返回示例：

{
  "responseCode": "1",
  "responseMessage": "success",
  "responseType": null,
  "data": [
    {
      "companyUuid": "uatTest_companyasdf123sa1s",
      "externalCompanyUuid": null,
      "externalEmployeeUuid": "extEmpuuidtest",
      "employeeNo": "N1111",
      "name": "秋瑾",
      "gender": "女",
      "cellphone": "18112341234",
      "employeeUuid": "da13bf5c-55ad-4255-a535-0fd6a2a8a50c",
      "photoUrl": "http://image.qfstatic.com/csh/d30/a142/e14414/p807//ec1b682a1cb643ea819d15102e15ba41.jpeg"
    },
    {
      "companyUuid": "swaggerCompanyUuid",
      "externalCompanyUuid": null,
      "externalEmployeeUuid": "lwjtestemployeeuuid",
      "employeeNo": "N002",
      "name": "史泰龙",
      "gender": "男",
      "cellphone": "18112345678",
      "employeeUuid": "3792eb45-3848-42d7-bb33-0b4dbc14bc69",
      "photoUrl": "//image.qfstatic.com/32221635-C638-4A8E-8F26-8E7C6B58EAEB/2019/03/20190319/3cb65c7583a14e81a5c6e98e10f274e2.png"
    }
  ]
}

查询有效员工

请求方式：POST

请求地址：/api/marketingopenapi/employee/listValidEmployeeByUuids

  • 请求header中需要传"appId"
  • 根据uuids查询员工信息（不包含删除的)
  • 这里的uuid都是从营销库获得, 与sass系统不是同一个uuid

请求参数：

参数 描述 数据类型 必填 字段长度
uuids 员工UUID集合 List<String> 是 [1,200]

请求示例：

{
  "uuids": [
    "fbfa795f-3146-41ef-a131-38b136a8fe58"
  ]
}

返回参数：

参数 数据类型 描述
name String 员工姓名
gender String 性别
cellphone String 手机
photoUrl String 头像
employeeUuid String 员工Uuid
employeeNo String 员工编号
updatedTime Date 更新时间
companyUuid String 营销公司uuid
externalCompanyUuid String SaaS公司uuid
externalEmployeeUuid String SaaS员工uuid, 可用于调用【人事】分类下接口员工uuid的入参(仅V20可用)

返回示例：

{
  "responseCode": "1",
  "responseMessage": "success",
  "responseType": null,
  "data": [
    {
      "companyUuid": "uatTest_companyasdf123sa1s",
      "externalCompanyUuid": null,
      "externalEmployeeUuid": "extEmpuuidtest",
      "employeeNo": "N1111",
      "name": "秋瑾",
      "gender": "女",
      "cellphone": "18112341234",
      "employeeUuid": "da13bf5c-55ad-4255-a535-0fd6a2a8a50c",
      "photoUrl": "http://image.qfstatic.com/csh/d30/a142/e14414/p807//ec1b682a1cb643ea819d15102e15ba41.jpeg"
    },
    {
      "companyUuid": "swaggerCompanyUuid",
      "externalCompanyUuid": null,
      "externalEmployeeUuid": "lwjtestemployeeuuid",
      "employeeNo": "N002",
      "name": "史泰龙",
      "gender": "男",
      "cellphone": "18112345678",
      "employeeUuid": "3792eb45-3848-42d7-bb33-0b4dbc14bc69",
      "photoUrl": "//image.qfstatic.com/32221635-C638-4A8E-8F26-8E7C6B58EAEB/2019/03/20190319/3cb65c7583a14e81a5c6e98e10f274e2.png"
    }
  ]
}

分页拉取资源

请求方式：POST

请求地址：/api/marketingopenapi/company/pullResourceUuidList

  • 请求header中需要传"appId"
  • 根据资源类型获得resourceUuid就是对应资源uuid, 比如resourceType=PROPERTY_PHOTO, resourceUuid就是查询房源图片入参的uuid

请求参数：

参数名 描述 数据类型 必填 字段说明
资源类型
resourceType 资源类型
 String 是 PROPERTY_BASE:房源基础信息,
PROPERTY_VIDEO:房源视频,
PROPERTY_VR_INFO:房源VR 信息,
PROPERTY_VR_PHOTO:房源2D-VR图片,
BROKER_INFO:经纪人,
PROPERTY_ROLE:房源角色人（09-16）,
PROPERTY_INSPECTION:房源带看记录（09-16）,
PROPERTY_TRANSACTION:房源成交记录（暂未开放）,
PROPERTY_PHOTO:房源图片
分页遍历dto
windowSize 窗口大小 String 是 取值[1,200]
useAsc 是否升序 Boolean 是 true：升序；false:降序
scrollId 滚动遍历ID Long 否 Long 第一次为空，第二次传上次返回的值，用于遍历数据（拉取所有数据）, 升序从小到大拉取数据, 降序从大到小拉取数据
startUpdatedTime 起始更新时间 Date 否 如："2019-03-06 13:00:00"
endUpdatedTime 结束更新时间 Date 否 如："2019-03-07 12:00:00"

请求示例：

{
  "dto": {
    "useAsc": true,
    "windowSize": 10,
    "scrollId": 0,
    "startUpdatedTime": "2019-03-06 13:00:00",
    "endUpdatedTime": "2019-03-07 12:00:00"
  },
  "resourceType": "PROPERTY_VR_INFO"
}

返回参数：

参数 描述 数据类型
scrollId 滚动遍历ID，没有后续值时候为null Long
listSize 返回list的大小，为0表示没有值 Integer
resourceUUid 资源Uuid String
resourceDeleted 资源删除标志 true:已删除;false:未删除 Boolean
resourceUpdatedTime 资源更新时间 Long

返回示例：

{
  "data": {
    "list": [
      {
        "resourceDeleted": true,
        "resourceUpdatedTime": 1588909886000,
        "resourceUuid": "9b4ece39bce6456f83bc7dbba5660ac8"
      },
      {
        "resourceDeleted": true,
        "resourceUpdatedTime": 1590567745000,
        "resourceUuid": "b237b254c57a4b49b8793944d09b0fad"
      },
      {
        "resourceDeleted": false,
        "resourceUpdatedTime": 1586943304000,
        "resourceUuid": "7af0707e0d3244509c36a21b2399ab46"
      },
      {
        "resourceDeleted": true,
        "resourceUpdatedTime": 1590571179000,
        "resourceUuid": "2fe40d02af194cb48f4a6d0d314fd81d"
      },
      {
        "resourceDeleted": false,
        "resourceUpdatedTime": 1586943306000,
        "resourceUuid": "c84d2f80f16f424eb6d52f5dc17d54b4"
      },
      {
        "resourceDeleted": false,
        "resourceUpdatedTime": 1586943306000,
        "resourceUuid": "ca58f3bb045b4b88aca11a1cd5562658"
      },
      {
        "resourceDeleted": false,
        "resourceUpdatedTime": 1586943306000,
        "resourceUuid": "6af4a9b2394946ea9af3a4c68f4604df"
      },
      {
        "resourceDeleted": false,
        "resourceUpdatedTime": 1586943308000,
        "resourceUuid": "2358d1ced1064dfe8e0b13cf13077787"
      },
      {
        "resourceDeleted": false,
        "resourceUpdatedTime": 1586943308000,
        "resourceUuid": "3bc98a55940340f2922fe07b212730e4"
      },
      {
        "resourceDeleted": false,
        "resourceUpdatedTime": 1586943308000,
        "resourceUuid": "9ab1718c92134e70ba8b9dcff278375e"
      }
    ],
    "listSize": 10,
    "scrollId": 11
  },
  "responseCode": "1",
  "responseMessage": "success"
}

查询全部房源

请求方式：POST

请求地址：/api/marketingopenapi/commonhouse/listPropertyByUuids

  • 请求header中需要传"appId"
  • 传入propertyBaseUuids/propertyUuids个数最多为10个,俩个uuid必须传其中一个

请求参数：

参数 描述 数据类型 必填
propertyBaseUuids 公共营销房房源UUID集合 List<String> 否
propertyUuids SaaS房源UUID集合 List<String> 否(仅V20支持)

请求示例：

{
  "propertyBaseUuids": [
    "42d826f8-4dd0-4afe-b9ac-d3b1239b1e59"
  ]
}

返回参数：

参数 描述 数据类型 字段说明
propertyBaseUuid 唯一标示 String 公共营销房房源UUID 主键uuid
companyUuid 公司uuid String 公共营销公司uuid, 非业务公司uuid
propertyUuid 房源uuid String SaaS房源UUID
propertyNo 房源编号 String SaaS房源编号
districtName 区域名称 String 区域名称
areaName 商圈名称 String
estateName 楼盘名称 String
estateUuid 外部楼盘 uuid String
price 出售价格 float 出售价格, 单位：元
guidePrice 政府指导价 float 政府指导价, 单位：元
salePrice 出售价格 float 出售价格, 单位：元
rentPrice 出租价格 float 出租价格, 单位：元
sellBasePrice 售底价 元 bigDecimal
rentBasePrice 租底价 元 bigDecimal
shi 室 int 与几房同义
ting 厅 int
wei 卫 int
floor 所在楼层 int
totalFloor 总楼层 int
square 面积(平方米) float 面积(建筑面积)平方米; 备注: 套内面积请用下面internalSquare字段
direction 朝向 int 对应说明 1: 东 2: 南 3: 西 4: 北 5: 东南 6: 东北 7: 西南 8: 西北 9: 南北 10: 东西
completeYear 建造年代 String
decoration 装修情况 int 对应说明 1: 毛坯 2: 简单装修 4: 精装修 6: 高端装修
usageTypeId 用途 int 对应说明 1: 普通住宅 2: 别墅 4: 公寓 5: 平房 6: 其他 7: 新里洋房 8: 老公房 9: 四合院 10: 排屋
tradeType 交易类型或状态 String 交易类型或状态（出售/出租）
equityYear 房源标签（满N） String 房源标签（满N）=['FIVE','TWO']
employeeName 角色人名称 String 角色人名称（首次录入人）
employeeUuid 角色人uuid String 角色人uuid
picture 房源图片 String 见(json)

propertyDeleted 房源是否删除 Boolean 房源是否删除（false：房源有效[状态有效,审核通过，非封盘，非保护房]，true：房源无效或不开放）
hasKey 是否有钥匙 Boolean 房源标签（是否有钥匙）
exclusive 是否独家 Boolean 房源标签（是否独家）
delegateTime 委托时间（挂牌时间） Date
longitude 经度（仅V20支持） Double
latitude 纬度（仅V20支持） Double
updatedTime 更新时间 Date 时间戳
tradeStatus 状态 String 状态值: 出租、出售、租售、预定、暂缓、已租、已售、无效有效、成交、我租、我售、已租、已售、未知、无有效电话 等
propertyCreatedTime 房源创建时间 Date
address 详细地址 String
internalSquare 套内面积 平方米 bigDecimal
kitchen 厨房 int 值：0、1、2、3、4、5、6、7、8、9 (单选，仅支持V20)
balcony 阳台 int 值：0、1、2、3、4、5、6、7、8、9 (单选)
elevator 电梯 boolean
rentType 租房方式 int 1，整租，2,合租; (仅V20支持)
paymentTerms 付款方式 int 1：付1押1 2：付1押2 3：付2押1 4：付2押2 5：付3押1 6：付3押2 7：面议
8：半年付 9：年付 10：半年付押1 11：半年付不押 12：年付不押 13：年付押1 14：其他
independFacilities 出租房屋配套 int 说明: 1，冰箱,2，电视,3，洗衣机,4，热水器,5，空调,6，宽带,7，沙发,8，床（独）, 9，暖气,10，衣柜,11，可做饭,12，卫生间,13，阳台,14，天燃气，15，椅子，16，桌子，17，微波炉，18，电风扇，19，其他 (仅V20支持)
rentPriceInclude 费用是否包含在月租 int 1.水费、2.电费、3.燃气费、4.宽带费、5.暖气费、6.物业费、7.其他、8.有线电视费、9.停车费 ;(仅V20支持)
rentExpireTime 租约到期时间 Date（long表示） (暂不支持)
grade 等级 int 对应说明：1.A（急迫）；2.B（较强）；3.C（一般）；4.D（较弱）；5.E（暂不关注）；6.F（其他）
propertyEquityYear 房本年限 String(枚举) 3,不满两年、2,满两年、1,满五年
buyTime 购买日期 Date （long表示）
sellCause 售房原因 String
onlyHouse 唯一住房 boolean
credit 有无贷款 boolean
creditRemark 贷款说明 String 数字，若有贷款，显示贷款金额：x万元；若无贷款，显示贷款金额：0万元
delegateType 委托方式 int 1.独家、2.一般委托、3.签赔、4.包租、5.托管、6.收购、7.未签、8.其他
handOverDate 交房日期 Date（long表示） (仅V10支持)
recordNo 备案号 String (仅V10支持)
consignStartDate 委托开始时间 Date（long表示） (仅V10支持)
consignEndDate 委托结束时间 Date（long表示） (仅V10支持)
consignRemark 交房备注 String (仅V10支持)
propertyLabel 标签 int
优质房（笋盘）：2、
聚焦房：4、
速销房：8、
如：优质房+聚焦房 6，类似于777的表示法
remark 房源备注 String
occupancy 房屋现状 int 1,业主自住、2,空置、3,客租住、4,已售出、5,其他 、6.未知
equityType 产权类型 int 1,商品房、5,售后公房、3,经济适用房、4,保障性住房、2,配套商品房、6,军产房、7,动迁安置房、8,其他、9.小产权房
taxType 包税费 int 1,各付、2,到手、3,包税、4,其他
supportFacilities 配套房屋设施 String 1，冰箱,2，电视,3，洗衣机,4，热水器,5，空调,6，宽带,7，沙发,8，床（独）,9，暖气,
10，衣柜,11，可做饭,12，卫生间,13，阳台,14，天燃气，15，椅子，16，桌子，17，微波炉，18，电风扇，19，其他，20.智能门锁，21.油烟机 (仅V20支持)
managementFee 物业管理费 String
park 有无车位 boolean (仅V10支持)
parkType 车位类型 int 1,地上车位、2,地下车位、3,其他 (仅V10支持)
buyPaymentType 购房付款方式 int 1,一次付清、2,按揭方式、3,资垫解按、4,其他、5：分批次付款
certificationNo 产证号 String
propertyRightYear 产权年限 int 1,70年、2,50年、3,40年、4,永久产权，5：30年、6:20年;（仅V20支持)
descriptionTitle 描述标题 String （仅V10支持）
propertyDesc 房源描述 String
environment 周边信息 String 周边小区配套等说明，文本 (仅V20支持)
consignCode 委托编码 String 委托合同
verifyCode 房源核验码（备案编号） String
verifyQrCode 房源核验二维码 String 核验二维码图片url
verifyInfoDeleted 房源核验信息删除状态 boolean
buildingForm 建筑形式 int 1板楼 2塔楼 3板塔结合 (仅V20支持)
heating 房屋供暖情况 int 1集体供暖 2自供暖(分散供暖) 3不供暖(仅V20支持)
households 几户 int (仅V20支持)
ladder 几梯 int (仅V20支持)
apartmentIntro 户型介绍 String 否(仅V20支持)
ownerMentality 业主心态 String 否(仅V20支持)
privyEnum 楼盘属性 int（枚举） 1：公盘、2：私盘、3：特盘、4：封盘 (仅V20支持)
usageTypeFir 一级用途 int 1:"住宅";2:"别墅";3:"商住";4:"商铺";5:"写字楼";99:"其他
usageTypeFirEnum 一级用途 int 1：住宅、2：别墅、3：商住、4：商铺、5：写字楼、6：其他(仅V20支持)
usageTypeSec 二级用途 String 自定义文本，如普通住宅、叠墅、公寓 (仅V20支持)
externalDeleted SaaS房源删除字段 boolean (仅V20支持)
protectedFlag 是否开保护房 boolean (仅V20支持)
privy 属性 int
ownershipName 权属方名称 String
ownershipNo 权属方证件号码 String
ownershipCertificateType 权属证明类型 String
title 房源标题 String
totalScore 房源分 float (仅V20支持)
返回参数（房源图片）
参数 参数说明 类型
category 图片类型(1:INDOOR（室内图） 2:PLANS（户型图、平面图） 3:OUTDOOR（室外图） 其他：OTHER)； Integer
imageType 户型图、卧室、厨房、客厅、卫生间、其他 等 String
photoUuid 图片 uuid String
url 图片 url String
isCover 是否为封面图{0:否，1：是} Integer
watermarkAlign SouthEast等 图片水印位置 枚举
watermarkImageUrl 水印图片 String

返回示例：

{
  "responseCode": "1",
  "responseMessage": "success",
  "responseType": null,
  "data": [
    {
      "propertyBaseId": 829,
      "propertyBaseUuid": "42d826f8-4dd0-4afe-b9ac-d3b1239b1e59",
      "companyUuid": "76b0e5ba-03b2-41af-8d5a-e1f7bf7fdf20",
      "propertyId": 0,
      "propertyNo": "string5",
      "propertyUuid": "444444",
      "bindCommunityId": "string",
      "systemID": 0,
      "districtName": "string",
      "areaName": "string",
      "estateName": "string",
      "estateUuid": "string",
      "shi": 0,
      "ting": 0,
      "wei": 0,
      "floor": 0,
      "totalFloor": 0,
      "square": 0,
      "direction": 0,
      "completeYear": 0,
      "decoration": 0,
      "usageTypeId": 0,
      "tradeType": "出售",
      "equityYear": "5",
      "price": 0,
      "rentPrice": 0,
      "employeeName": "string",
      "employeeUuid": "string",
      "picture": "[{\"category\":0,\"isCover\":0,\"photoUuid\":\"string\",\"url\":\"string\"}]",
      "propertyDeleted": true,
      "preview": true,
      "hasKey": true,
      "exclusive": true,
      "delegateTime": 1554439822000,
      "longitude": 0,
      "latitude": 0,
      "updatedUserUuid": null,
      "createdUserUuid": null,
      "createdUserId": null,
      "updatedUserId": null
    }
  ]
}

查询有效房源

  • 使用uuid批量查询，可以查到有效的房源

请求方式：POST

请求地址：/api/marketingopenapi/commonhouse/listValidPropertyBaseByUuids

  • 请求header中需要传"appId"
  • 通过uuids获取房源详情信息(不包含无效, 即只可获取出租,出售.租售房源)
  • 想要同时获得无效房源,使用上面/api/marketingopenapi/commonhouse/listPropertyByUuids 接口
  • 传入uuid/propertyUuids个数最多为10个, 俩个uuid必须传其中一个

请求参数：

参数 描述 数据类型 必填 字段长度
uuids 公共营销房源propertyBaseUuid集合 List<String> 否 [1,10]
propertyUuids SaaS房源uuid集合 List<String> 否,(仅V20支持) [1,10]

请求示例：

{
  "uuids": [
    "bca5bcd9-e4fc-4f0f-9a64-20000dd87b0c",
    "14101d6e-e8ab-4641-991f-014c0a0feb67"
  ]
}

返回参数：

参数 描述 数据类型 字段说明
propertyBaseUuid 唯一标示 String 公共营销房源UUID 主键
companyUuid 公司uuid String 公共营销公司uuid, 非业务公司uuid
propertyUuid 房源uuid String SaaS房源uuid
propertyNo 房源编号 String SaaS房源编号
districtName 区域名称 String 区域名称
areaName 商圈名称 String
estateName 楼盘名称 String
estateUuid 外部楼盘 uuid String
price 出售价格 float 出售价格, 单位：元
guidePrice 政府指导价 float 政府指导价, 单位：元
salePrice 出售价格 float 出售价格, 单位：元
rentPrice 出租价格 float 出租价格, 单位：元
sellBasePrice 售底价 元 bigDecimal
rentBasePrice 租底价 元 bigDecimal
shi 室 int 与几房同义
ting 厅 int
wei 卫 int
floor 所在楼层 int
totalFloor 总楼层 int
square 面积(平方米) float 面积(建筑面积)平方米; 备注: 套内面积请用下面internalSquare字段
direction 朝向 int 对应说明 1: 东 2: 南 3: 西 4: 北 5: 东南 6: 东北 7: 西南 8: 西北 9: 南北 10: 东西
completeYear 建造年代 String
decoration 装修情况 int 对应说明 1: 毛坯 2: 简单装修 4: 精装修 6: 高端装修
usageTypeId 用途 int 对应说明 1: 普通住宅 2: 别墅 4: 公寓 5: 平房 6: 其他 7: 新里洋房 8: 老公房 9: 四合院 10: 排屋
tradeType 交易类型或状态 String 交易类型或状态（出售/出租）
equityYear 房源标签（满N） String 房源标签（满N）=['FIVE','TWO']
employeeName 角色人名称 String 角色人名称（首次录入人）
employeeUuid 角色人uuid String 角色人uuid
picture 房源图片 String 见(json)

propertyDeleted 房源是否删除 Boolean 房源是否删除（false：房源有效[状态有效,审核通过，非封盘，非保护房]，true：房源无效或不开放）
hasKey 是否有钥匙 Boolean 房源标签（是否有钥匙）
exclusive 是否独家 Boolean 房源标签（是否独家）
delegateTime 委托时间（挂牌时间） Date
longitude 经度（仅V20支持） Double
latitude 纬度（仅V20支持） Double
updatedTime 更新时间 Date 时间戳
tradeStatus 状态 String 状态值: 出租、出售、租售、预定、暂缓、已租、已售、无效有效、成交、我租、我售、已租、已售、未知、无有效电话 等
propertyCreatedTime 房源创建时间 Date
address 详细地址 String
internalSquare 套内面积 平方米 bigDecimal
kitchen 厨房 int 值：0、1、2、3、4、5、6、7、8、9 (单选，仅支持V20)
balcony 阳台 int 值：0、1、2、3、4、5、6、7、8、9 (单选)
elevator 电梯 boolean
rentType 租房方式 int 1，整租，2,合租; (仅V20支持)
paymentTerms 付款方式 int 1：付1押1 2：付1押2 3：付2押1 4：付2押2 5：付3押1 6：付3押2 7：面议
8：半年付 9：年付 10：半年付押1 11：半年付不押 12：年付不押 13：年付押1 14：其他
independFacilities 出租房屋配套 int 说明: 1，冰箱,2，电视,3，洗衣机,4，热水器,5，空调,6，宽带,7，沙发,8，床（独）, 9，暖气,10，衣柜,11，可做饭,12，卫生间,13，阳台,14，天燃气，15，椅子，16，桌子，17，微波炉，18，电风扇，19，其他 (仅V20支持)
rentPriceInclude 费用是否包含在月租 int 1.水费、2.电费、3.燃气费、4.宽带费、5.暖气费、6.物业费、7.其他、8.有线电视费、9.停车费 ;(仅V20支持)
rentExpireTime 租约到期时间 Date（long表示） (暂不支持)
grade 等级 int 对应说明：1.A（急迫）；2.B（较强）；3.C（一般）；4.D（较弱）；5.E（暂不关注）；6.F（其他）
propertyEquityYear 房本年限 String(枚举) 3,不满两年、2,满两年、1,满五年
buyTime 购买日期 Date （long表示）
sellCause 售房原因 String
onlyHouse 唯一住房 boolean
credit 有无贷款 boolean
creditRemark 贷款说明 String 数字，若有贷款，显示贷款金额：x万元；若无贷款，显示贷款金额：0万元
delegateType 委托方式 int 1.独家、2.一般委托、3.签赔、4.包租、5.托管、6.收购、7.未签、8.其他
handOverDate 交房日期 Date（long表示） (仅V10支持)
recordNo 备案号 String (仅V10支持)
consignStartDate 委托开始时间 Date（long表示） (仅V10支持)
consignEndDate 委托结束时间 Date（long表示） (仅V10支持)
consignRemark 交房备注 String (仅V10支持)
propertyLabel 标签 int
优质房（笋盘）：2、
聚焦房：4、
速销房：8、
如：优质房+聚焦房 6，类似于777的表示法
remark 房源备注 String
occupancy 房屋现状 int 1,业主自住、2,空置、3,客租住、4,已售出、5,其他 、6.未知
equityType 产权类型 int 1,商品房、5,售后公房、3,经济适用房、4,保障性住房、2,配套商品房、6,军产房、7,动迁安置房、8,其他、9.小产权房
taxType 包税费 int 1,各付、2,到手、3,包税、4,其他
supportFacilities 配套房屋设施 String 1，冰箱,2，电视,3，洗衣机,4，热水器,5，空调,6，宽带,7，沙发,8，床（独）,9，暖气,
10，衣柜,11，可做饭,12，卫生间,13，阳台,14，天燃气，15，椅子，16，桌子，17，微波炉，18，电风扇，19，其他，20.智能门锁，21.油烟机 (仅V20支持)
managementFee 物业管理费 String
park 有无车位 boolean (仅V10支持)
parkType 车位类型 int 1,地上车位、2,地下车位、3,其他 (仅V10支持)
buyPaymentType 购房付款方式 int 1,一次付清、2,按揭方式、3,资垫解按、4,其他、5：分批次付款
certificationNo 产证号 String
propertyRightYear 产权年限 int 1,70年、2,50年、3,40年、4,永久产权，5：30年、6:20年;（仅V20支持)
descriptionTitle 描述标题 String （仅V10支持）
propertyDesc 房源描述 String
environment 周边信息 String 周边小区配套等说明，文本 (仅V20支持)
consignCode 委托编码 String 委托合同
verifyCode 房源核验码（备案编号） String
verifyQrCode 房源核验二维码 String 核验二维码图片url
verifyInfoDeleted 房源核验信息删除状态 boolean
buildingForm 建筑形式 int 1板楼 2塔楼 3板塔结合 (仅V20支持)
heating 房屋供暖情况 int 1集体供暖 2自供暖(分散供暖) 3不供暖(仅V20支持)
households 几户 int (仅V20支持)
ladder 几梯 int (仅V20支持)
apartmentIntro 户型介绍 String 否(仅V20支持)
ownerMentality 业主心态 String 否(仅V20支持)
privyEnum 楼盘属性 int（枚举） 1：公盘、2：私盘、3：特盘、4：封盘 (仅V20支持)
usageTypeFir 一级用途 int 1:"住宅";2:"别墅";3:"商住";4:"商铺";5:"写字楼";99:"其他
usageTypeFirEnum 一级用途 int 1：住宅、2：别墅、3：商住、4：商铺、5：写字楼、6：其他(仅V20支持)
usageTypeSec 二级用途 String 自定义文本，如普通住宅、叠墅、公寓 (仅V20支持)
externalDeleted SaaS房源删除字段 boolean (仅V20支持)
protectedFlag 是否开保护房 boolean (仅V20支持)
privy 属性 int
ownershipName 权属方名称 String
ownershipNo 权属方证件号码 String
ownershipCertificateType 权属证明类型 String
title 房源标题 String
totalScore 房源分 float (仅V20支持)
返回参数（房源图片）
参数 参数说明 类型
category 图片类型(1:INDOOR（室内图） 2:PLANS（户型图、平面图） 3:OUTDOOR（室外图） 其他：OTHER)； Integer
imageType 户型图、卧室、厨房、客厅、卫生间、其他 等 String
photoUuid 图片 uuid String
url 图片 url String
isCover 是否为封面图{0:否，1：是} Integer
watermarkAlign SouthEast等 图片水印位置 枚举
watermarkImageUrl 水印图片 String

返回示例：

{
  "data": [
    {
      "address": "上海市杨浦区控江路59弄",
      "areaName": "周家嘴路",
      "companyUuid": "62557853-a223-489a-a144-d675210227d1",
      "completeYear": 2000,
      "decoration": 2,
      "delegateTime": 1547192412000,
      "direction": 2,
      "districtName": "杨浦区",
      "employeeName": "张平专用",
      "employeeUuid": "30b46ab5-0264-4358-a6e7-9d8b4022136e",
      "estateName": "控江路59弄",
      "estateUuid": "933d97c61e78436fbb60a26155304bd0",
      "exclusive": false,
      "floor": 11,
      "hasKey": false,
      "internalSquare": 120.00,
      "price": 1000000.0,
      "propertyBaseUuid": "14101d6e-e8ab-4641-991f-014c0a0feb67",
      "propertyUuid": "99999",
      "propertyCreatedTime": 1547192412000,
      "propertyDeleted": false,
      "rentPrice": 1000.0,
      "shi": 1,
      "square": 120.0,
      "ting": 0,
      "totalFloor": 12,
      "tradeStatus": "租售",
      "tradeType": "租售",
      "usageTypeId": 1,
      "wei": 0
    },
    {
      "address": "上海浦东新区华夏中路958弄",
      "areaName": "孙桥",
      "companyUuid": "62557853-a223-489a-a144-d675210227d1",
      "completeYear": 2005,
      "decoration": 2,
      "delegateTime": 1586418171000,
      "direction": 2,
      "districtName": "浦东新区",
      "employeeName": "汤雅君",
      "employeeUuid": "0c25ce8d-60b0-4f46-b635-660a38f36757",
      "estateName": "盛大天地青春里(一期)",
      "estateUuid": "1dc1c96b681e4f20b5de37a6cd8beece",
      "exclusive": false,
      "floor": 1,
      "hasKey": true,
      "internalSquare": 99.00,
      "latitude": 31.179,
      "longitude": 121.61,
      "occupancy": 1,
      "picture": "[{\"category\":3,\"imageType\":\"其他\",\"isCover\":0,\"photoUuid\":\"69330e71-b194-4d2d-8021-f3394405e9c1\",\"url\":\"//image.qfstatic.com/saas2_test2_company3_company7j8h6gh5tf/2020/04/20200409/51f95b8875c849318748960e1cf7a758.png\",\"watermarkAlign\":\"SouthEast\",\"watermarkImageUrl\":\"//image.qfstatic.com/saas2_test2_company3_company7j8h6gh5tf/2020/02/20200224/030ab028830f48d0b4b3ecf8ceef7b03.png\"},{\"category\":1,\"imageType\":\"卧室\",\"isCover\":0,\"photoUuid\":\"de922361-4d67-4bef-953b-d0a40c9e95b9\",\"url\":\"//image.qfstatic.com/saas2_test2_company3_company7j8h6gh5tf/2020/04/20200409/eae211caec594f31bf45048b05ea445c.png\",\"watermarkAlign\":\"SouthEast\",\"watermarkImageUrl\":\"//image.qfstatic.com/saas2_test2_company3_company7j8h6gh5tf/2020/02/20200224/030ab028830f48d0b4b3ecf8ceef7b03.png\"},{\"category\":2,\"imageType\":\"户型图\",\"isCover\":0,\"photoUuid\":\"38388296-5ca2-4450-8381-6e4b6afef4a3\",\"url\":\"//image.qfstatic.com/saas2_test2_company3_company7j8h6gh5tf/2020/04/20200409/87b32abe8d4d468ab12645f4c87af27e.png\",\"watermarkAlign\":\"SouthEast\",\"watermarkImageUrl\":\"//image.qfstatic.com/saas2_test2_company3_company7j8h6gh5tf/2020/02/20200224/030ab028830f48d0b4b3ecf8ceef7b03.png\"}",
      "price": 2000000.0,
      "propertyBaseUuid": "bca5bcd9-e4fc-4f0f-9a64-20000dd87b0c",
      "propertyUuid": "888888",
      "propertyCreatedTime": 1586411308000,
      "propertyDeleted": false,
      "rentPrice": 5000.0,
      "shi": 2,
      "square": 105.0,
      "ting": 0,
      "totalFloor": 10,
      "tradeStatus": "出租",
      "tradeType": "出租",
      "usageTypeId": 1,
      "wei": 0
    }
  ],
  "responseCode": "1",
  "responseMessage": "success"
}

查询房源视频

请求方式：POST

请求地址：/api/marketingopenapi/commonhouse/listValidPropertyVideoByUuids

  • 请求header中需要传"appId"
  • 通过uuids查询房源视频信息(不包含删除的)

请求参数：

参数 描述 数据类型 必填 字段长度
uuids 房源videoUuid集合 List<String> 是 [1,200]

请求示例：

{
  "uuids": [
    "3997af96-8bf0-4f52-8af0-e89044dde10a"
  ]
}

返回参数：

参数 描述 数据类型
videoUuid uuid String
propertyBaseUuid 公共营销房源uuid（2025.1.1不再维护，替换字段:propertyUuid) String
companyUuid 公共营销公司uuid String
propertyUuid SaaS房源uuid String
externalVideoUuid 外部房源视频Uuid String
originalVideoUrl 原视频链接 String
encodingVideoUrl 编码视频链接 String
watermarkVideoUrl 加水印视频链接 String
thumbnailUrl 缩略图链接 String
videoDeleted 是否被删除 true:已删除 false:未删除 Boolean
updatedTime 更新时间 Date

返回示例：

{
  "data": [
    {
      "companyUuid": "62557853-a223-489a-a144-d675210227d1",
      "originalVideoUrl": "//image.qfstatic.com/saas2_test2_company3_company7j8h6gh5tf/video/2019/09/27/IMG_0528MP4_target.mp4",
      "propertyBaseUuid": "42160d75-122f-44cd-bf97-81899383f3ab",
      "thumbnailUrl": "//image.qfstatic.com/saas2_test2_company3_company7j8h6gh5tf/2019/09/20190927/2cef333efab64f42ac0aaade8c5cfab0.jpeg",
      "updatedTime": 1593572490000,
      "videoDeleted": false,
      "videoUuid": "3997af96-8bf0-4f52-8af0-e89044dde10a",
      "watermarkVideoUrl": "//image.qfstatic.com/saas2_test2_company3_company7j8h6gh5tf/video/2019/09/27/IMG_0528MP4_target.mp4"
    }
  ],
  "responseCode": "1",
  "responseMessage": "success"
}

查询全景房VR

请求方式：POST

请求地址：/api/marketingopenapi/commonhouse/listValidPropertyVrInfoByUuids

  • 请求header中需要传"appId"
  • 通过uuids查询全景房VR信息(不包含删除的)

请求参数：

参数 描述 数据类型 必填 字段长度
uuids 房源vrInfoUuid集合 List<String> 是 [1,200]

请求示例：

{
  "uuids": [
    "71e5de8cfca244919af4161602f380c0",
    "bc5d7f56c67744e2a8a9fd1def6d8722"
  ]
}

返回参数：

参数 描述 数据类型
vrInfoUuid uuid String
propertyBaseUuid 公共营销房源uuid（2025.1.1不再维护，替换字段:propertyUuid) String
companyUuid 公共营销公司uuid String
propertyUuid SaaS房源uuid（建议使用，对应listValidPropertyBaseByUuids#propertyUuid） String
roamViewUrl 全景房渲染url String
vrDeleted 是否被删除 true:已删除 false:未删除 Boolean
cameraHeight 2D字段-拍摄高度（cm） Float
multiFloorFlag 2D字段-是否多个楼层标志位 true:是 false:否 Boolean
topFloor 2D字段-顶层floor Integer
bottomFloor 2D字段-底层floor Integer
direction 2D字段-朝向（东|西|南|北|东南|西南|东北|西北） String
sourceUrl 3D字段-压缩包地址（.zip） String
sourceHash 3D字段-hashcode(便于知道是否下载完成) String
coverPhotoUrl 3D素材包-封面图 String
updatedTime 更新时间 Date
propertyVrPhotoDTOS 图片列表 List<AddFranchiseeContactDTO>
返回参数（图片列表）
参数 描述 数据类型
vrPhotoUuid 图片uuid String
vrInfoUuid uuid String
companyUuid 营销系统内部公司uuid String
photoCategory 图片类别（房间 | 客/餐厅 | 厨卫 | 其他） String
photoSubCategory 图片子类别：房间（主卧|次卧|衣帽间|老人房|儿童房|书房|宠物房）;客/餐厅（客厅|餐厅）;厨卫（厨房|主卫|客卫）;其他（玄关|阳台|过道|厨房操作阳台|储物间|楼梯|车库|花园） String
photoUrl 全景图片url String
photoMeta 图片类别，如:image/JPG String
thumbnailPhotoUrl 缩略图url String
floorName 楼层名称 String
coverFlag 是否封面图标志位 true:是 false:否 Boolean
photoDeleted 是否被删除 true:已删除 false:未删除 Boolean
updatedTime 更新时间 Date

返回示例：

{
  "responseCode": "1",
  "responseMessage": "success",
  "data": [
    {
      "bottomFloor": 1,
      "cameraHeight": 145.0,
      "companyUuid": "62557853-a223-489a-a144-d675210227d1",
      "direction": "东南",
      "multiFloorFlag": false,
      "propertyBaseUuid": "14101d6e-e8ab-4641-991f-014c0a0feb67",
      "topFloor": 1,
      "updatedTime": 1586943306000,
      "vrDeleted": false,
      "vrInfoUuid": "ca58f3bb045b4b88aca11a1cd5562658",
      "propertyVrPhotoDTOS": [
        {
          "companyUuid": "62557853-a223-489a-a144-d675210227d1",
          "coverFlag": false,
          "floorName": "1层",
          "photoCategory": "房间",
          "photoDeleted": false,
          "photoMeta": "JPG",
          "photoSubCategory": "主卧",
          "photoUrl": "http://ppf0d6dh7.bkt.clouddn.com/saas2_test_company3_company7j8h6gh5tf%2Fvr%2F100RICOH_R0010539.JPG?imageView2/0/w/4096/h/4096&e=1557904388&token=3-aaKhHdGKHM4CLHf8KHGP7HbheQDGqPVuD1ovLC:EJ2Tt6gEiPvGrlcEjRx1ykIx4XY=",
          "thumbnailPhotoUrl": "//image.qfstatic.com/saas2_test_company3_company7j8h6gh5tf/2019/05/20190515/7b8a18284a634a489c764f4af263dba7.JPG",
          "updatedTime": 1586947010000,
          "vrInfoUuid": "ca58f3bb045b4b88aca11a1cd5562658",
          "vrPhotoUuid": "b42ed8fa1f994eac8552da80c67c69d1"
        },
        {
          "companyUuid": "62557853-a223-489a-a144-d675210227d1",
          "coverFlag": false,
          "floorName": "1层",
          "photoCategory": "厨卫",
          "photoDeleted": false,
          "photoMeta": "JPG",
          "photoSubCategory": "厨房",
          "photoUrl": "http://ppf0d6dh7.bkt.clouddn.com/saas2_test_company3_company7j8h6gh5tf%2Fvr%2F100RICOH_R0010541.JPG?imageView2/0/w/4096/h/4096&e=1557904393&token=3-aaKhHdGKHM4CLHf8KHGP7HbheQDGqPVuD1ovLC:IW6nOnnWmlxXYnbQ8hlj_XfqCTI=",
          "thumbnailPhotoUrl": "//image.qfstatic.com/saas2_test_company3_company7j8h6gh5tf/2019/05/20190515/865b9fe43ff24c35b2f8feba0d88b0ed.JPG",
          "updatedTime": 1586947010000,
          "vrInfoUuid": "ca58f3bb045b4b88aca11a1cd5562658",
          "vrPhotoUuid": "7307b851ed13450e88cbb1b6bb69f1c6"
        }
      ]
    }
  ]
}

查询全景房2D-VR图片

请求方式：POST

请求地址：/api/marketingopenapi/commonhouse/listValidPropertyVrPhotoByUuids

  • 请求header中需要传"appId"
  • 通过uuids查询获取全景房2D-VR图片信息(不包含删除的)

请求参数：

参数 描述 数据类型 必填 字段长度
uuids 房源vrPhotoUuid UUID集合 List<String> 是 [1,200]

请求示例：

{
  "uuids": [
    "5e31835b6fa74d8fa3db500ab62f7b3a",
    "264326c89168481690e643be92bf21f9",
    "7b51ee8c785943838e831e84fb096160"
  ]
}

返回参数：

参数 描述 数据类型
vrPhotoUuid 图片uuid String
vrInfoUuid uuid String
companyUuid 营销系统内部公司uuid String
photoCategory 图片类别（房间 | 客/餐厅 | 厨卫 | 其他） String
photoSubCategory 图片子类别：房间（主卧|次卧|衣帽间|老人房|儿童房|书房|宠物房）;客/餐厅（客厅|餐厅）;厨卫（厨房|主卫|客卫）;其他（玄关|阳台|过道|厨房操作阳台|储物间|楼梯|车库|花园） String
photoUrl 全景图片url String
photoMeta 图片类别，如:image/JPG String
thumbnailPhotoUrl 缩略图url String
floorName 楼层名称 String
coverFlag 是否封面图标志位 true:是 false:否 Boolean
photoDeleted 是否被删除 true:已删除 false:未删除 Boolean
updatedTime 更新时间 Date

返回示例：

{
  "data": [
    {
      "companyUuid": "62557853-a223-489a-a144-d675210227d1",
      "coverFlag": false,
      "floorName": "单层",
      "photoCategory": "房间",
      "photoDeleted": false,
      "photoMeta": "image/JPG",
      "photoSubCategory": "主卧",
      "photoUrl": "http://ppf0d6dh7.bkt.clouddn.com/saas2_test2_company3_company7j8h6gh5tf%2Fvr%2F2020%2F06%2F23%2F1592892439000R0010320.JPG",
      "thumbnailPhotoUrl": "http://image.qfstatic.com/saas2_test2_company3_company7j8h6gh5tf/2020/06/20200623/28cd92c4b97d473abf9b7dde5a837e2d.JPG",
      "updatedTime": 1592892433000,
      "vrInfoUuid": "bc5d7f56c67744e2a8a9fd1def6d8722",
      "vrPhotoUuid": "5e31835b6fa74d8fa3db500ab62f7b3a"
    },
    {
      "companyUuid": "62557853-a223-489a-a144-d675210227d1",
      "coverFlag": false,
      "floorName": "单层",
      "photoCategory": "厨卫",
      "photoDeleted": false,
      "photoMeta": "image/JPG",
      "photoSubCategory": "厨房",
      "photoUrl": "http://ppf0d6dh7.bkt.clouddn.com/saas2_test2_company3_company7j8h6gh5tf%2Fvr%2F2020%2F06%2F23%2F1592892447000R0010322.JPG",
      "thumbnailPhotoUrl": "http://image.qfstatic.com/saas2_test2_company3_company7j8h6gh5tf/2020/06/20200623/1b99b0a291ac44f98b2265528e906be6.JPG",
      "updatedTime": 1592892433000,
      "vrInfoUuid": "bc5d7f56c67744e2a8a9fd1def6d8722",
      "vrPhotoUuid": "264326c89168481690e643be92bf21f9"
    },
    {
      "companyUuid": "62557853-a223-489a-a144-d675210227d1",
      "coverFlag": false,
      "floorName": "单层",
      "photoCategory": "客/餐厅",
      "photoDeleted": false,
      "photoMeta": "image/JPG",
      "photoSubCategory": "客厅",
      "photoUrl": "http://ppf0d6dh7.bkt.clouddn.com/saas2_test2_company3_company7j8h6gh5tf%2Fvr%2F2020%2F06%2F23%2F1592892444000R0010321.JPG",
      "thumbnailPhotoUrl": "http://image.qfstatic.com/saas2_test2_company3_company7j8h6gh5tf/2020/06/20200623/1227a2cb542441f6b24be1a92d6aab2a.JPG",
      "updatedTime": 1592892433000,
      "vrInfoUuid": "bc5d7f56c67744e2a8a9fd1def6d8722",
      "vrPhotoUuid": "7b51ee8c785943838e831e84fb096160"
    }
  ],
  "responseCode": "1",
  "responseMessage": "success"
}

查询房源角色人

请求方式：POST

请求地址：/api/marketingopenapi/realhouse/listValidPropertyRoleByUuids

  • 请求header中需要传"appId"
  • 根据角色uuids查询房源角色人信息（不包含删除的)
  • 2024-06-25 14:14:53，确认逻辑：维护人只做了售维护人。
  • 2024-07-11 20:02:14，确认逻辑：对外openapi维护人取的是房源角色人中出售方
  • 2024-09-02 12:00:00 修订 guardianEmployeeUuid 对应20公司的出售方 请求参数：
参数 描述 数据类型 必填 字段长度
uuids 角色Uuid集合 List<String> 是 [1,200]

请求示例：

{
  "uuids": [
    "fbfa795f-3146-41ef-a131-38b136a8fe58"
  ]
}

返回参数：

参数 参数说明 类型 必传
roleSyncUuid 角色人记录Uuid String 是
companyUuid 第三方公司uuid String 是
propertyBaseUuid 营销房源propertyBaseUuid String 是
inputEmployeeUuid 录入人(首次录入人)Uuid String 是
guardianEmployeeUuid 出售人Uuid (维护人(房源归属人1)Uuid String 是
surveyEmployeeUuid 实勘人(实勘方)Uuid String 否
promotionEmployeeUuid 委托人(归属人2)Uuid String 否
entrustIndemnityEmployeeUuid 签赔方 String 否
keyEmployeeUuid 钥匙人(钥匙方)Uuid String 否
vrUploaderEmployeeUuid VR上传人账号Uuid（20200813新增） String 否
videoUploaderEmployeeUuid 视频上传人账号Uuid （20200813新增） String 否

返回示例：

{
  "responseCode": "1",
  "responseMessage": "success",
  "responseType": null,
  "data": [
    {
      "roleSyncUuid": "string",
      "companyUuid": "string",
      "propertyBaseUuid": "string",
      "guardianEmployeeUuid": "string",
      "inputEmployeeUuid": "string",
      "keyEmployeeUuid": "string",
      "promotionEmployeeUuid": "string",
      "propertyUuid": "string",
      "surveyEmployeeUuid": "string"
    }
  ]
}

根据房源UUID集合查询房源角色人信息（不包含删除的)

  • 请求header中需要传"appId"
  • 根据房源Uuids查询房源角色人信息（不包含删除的)
  • 房源UUID对应房源信息接口listValidPropertyBaseByUuids#propertyUuid 字段

请求方式：POST 请求地址：/api/marketingopenapi/realhouse/listValidPropertyRoleByPropertyUuids

请求参数：

参数名 描述 数据类型 必填 字节长度
propertyUuids 房源propertyUuid集合,size在[1,20] List<String> 是 —

请求示例：

{
  "propertyUuids": [
    "7ed551fdb8394182884001766f5317d2"
  ]
}

返回参数：

参数名 描述 类型 必传 长度
propertyUuid 房源propertyUuid String 是 100
inputEmployeeUuid 录入人(首次录入人)Uuid String 是 100
guardianEmployeeUuid 售维护人Uuid（仅20公司) String 是 100
guardianRentEmployeeUuid 租维护人Uuid（仅20公司） String 是 100
surveyEmployeeUuid 实勘人(实勘方)Uuid String 否 100
promotionEmployeeUuid 委托人(归属人2)Uuid String 否 100
entrustIndemnityEmployeeUuid 签赔人Uuid String 否 100
keyEmployeeUuid 钥匙人Uuid String 否 100
sellHolderEmployeeUuid 出售人Uuid String 否 100
rentHolderEmployeeUuid 出租人Uuid（仅20公司) String 否 100

返回示例：

{
  "responseCode": "1",
  "responseMessage": "success",
  "responseType": null,
  "data": [
    {
      "propertyUuid": "7ed551fdb8394182884001766f5317d2",
      "inputEmployeeUuid": "c5c845d5-8d54-4cbc-8295-fc616fabb0f7",
      "guardianSellEmployeeUuid": "0ee97d43-58c7-40cf-bd15-f2efb1462d6e",
      "guardianRentEmployeeUuid": null,
      "surveyEmployeeUuid": "6b896e6c-5ebc-46ac-9a5e-13b7743e157f",
      "promotionEmployeeUuid": "c5c845d5-8d54-4cbc-8295-fc616fabb0f7",
      "keyEmployeeUuid": "c5c845d5-8d54-4cbc-8295-fc616fabb0f7",
      "entrustIndemnityEmployeeUuid": null,
      "sellHolderEmployeeUuid": "c5c845d5-8d54-4cbc-8295-fc616fabb0f7",
      "rentHolderEmployeeUuid": null
    }
  ]
}

查询房源带看记录

请求方式：POST

请求地址：/api/marketingopenapi/realhouse/listValidPropertyInspectionByUuids

  • 请求header中需要传"appId"

请求参数：

参数 描述 数据类型 必填 字段长度
uuids 带看Uuid集合 List<String> 是 [1,200]

请求示例：

{
  "uuids": [
    "bfcfc71e-df53-47c5-ac0f-3fd01d1a804e"
  ]
}

返回参数：

参数 参数说明 类型
inspectionRecordSyncUuid 带看记录Uuid String
companyUuid 营销司uuid String
propertyBaseUuid 营销房源uuid String
propertyUuid SaaS房源uuid String
brokerageWorkId 带看ID String
customerId 客源uuid String
customerName 客源名称 String
employeeUuid 营销员工uuid String
followTime 带看时间 Date
workContent 带看反馈 String

返回示例：

{
  "responseCode": "1",
  "responseMessage": "success",
  "responseType": null,
  "data": [{
    "inspectionRecordSyncUuid": "bfcfc71e-df53-47c5-ac0f-3fd01d1a804e",
    "companyUuid": "ef531870-cc91-480d-9bf3-a92c94df614c",
    "propertyUuid": "3967a9b6a44a4084972168af93fc6de3",
    "brokerageWorkId": "1020269668717297665",
    "customerId": "3a7567edf1404e8c8a22d65748be2cf5",
    "customerName": "丛小伙",
    "employeeUuid": "303a9116-cde7-4f42-b228-62ca2d130ecb",
    "followTime": 1721177781000,
    "workContent": "带客户看看房子啊。。。",
    "propertyBaseUuid": "5f6b1977-b9d2-42b1-99b8-3a88af33e2df"
  }]
}

查询房源全部角色人

请求方式：POST

请求地址：/api/jediopenplatformopenapi/property/commonhouse/searchPropertyStakeholder

  • 根据SaaS房源UUID查询房源全部角色人信息(相关方)（不包含删除的)
  • 入参中SaaS房源uuid和修改时间必须传其中一个条件

请求参数：

参数 描述 数据类型 必填 备注
propertyUuids SaaS房源Uuid集合 Array<String> 否 uuid集合长度最多200个
modifyTimeStart 相关方修改开始时间 Date 否 时间戳
modifyTimeEnd 相关方修改结束时间 Date 否 时间戳

请求示例：

{
  "page": {
    "pageNum": 1,
    "pageSize": 20
  },
  "param": {
    "propertyUuids": [
      "fbfa795f-3146-41ef-a131-38b136a8fe58"
    ],
    "modifyTimeStart": 1675180800000,
    "modifyTimeEnd": 1677600000000
  }
}

返回参数：

参数 参数说明 类型 备注
propertyUuid 房源uuid String
stakeholders 相关⽅ array

相关方stakeholders:

参数 参数说明 类型 备注
stakeholderName 相关⽅名称 String 出售⽅,出租⽅,⾸录⽅,租维护⼈,售维护人等;
包含用户自定义的相关方
employeeUuid 员工uuid String saas公司员工uuid
employeeNo 员工编号 String SaaS员工编号
employeeName 员工名称 String SaaS员工名称
employeePhone 员工电话 String 员工电话

返回示例：

{
  "responseCode": "1",
  "responseMessage": "success",
  "responseType": null,
  "data": [
    {
      "propertyUuid": "9d14b3687d7145d05ca78446db3b225c",
      "stakeholders": [
        {
          "stakeholderName": "出售⽅",
          "employeeUuid": "8505283b5778b3349406dff92282e419",
          "employeeNo": "N001",
          "employeeName": "小明",
          "employeePhone": "13112345678"
        },
        {
          "stakeholderName": "售维护⼈",
          "employeeUuid": "54e013936938e04f92196682432e976c",
          "employeeNo": "N002",
          "employeeName": "大明",
          "employeePhone": "15112345678"
        }
      ]
    }
  ]
}

查询房源图片水印

请求方式：POST

请求地址：/api/marketingopenapi/commonhouse/listValidPropertyPhotoWatermarkByCompanyUuid

  • 请求header中需要传"appId"
  • 使用companyUuid查询, 查到有效的房源图片的水印

请求参数：

参数 描述 数据类型 必填 字段长度
data 营销公司uuid String 是

请求示例：

{
  "data": "60ce1def-14ff-4b80-a8f8-e1b070b6b29e"
}

返回参数：

名称 描述 数据类型
companyUuid 公司uuid String
watermarkEnable 是否开启水印 （TRUE:开启; FALSE:关闭） String
watermarkAlign 图片水印位置 （NorthWest:顶部居左; North:顶部居中; NorthEast:顶部居右; West:中部居左; Center:图片中心; East:中部居右; SouthWest:底部居左; South:底部居中;SouthEast:底部居右） String
watermarkType 水印类型 （IMAGE:图片水印; TEXT:文本水印） String
watermarkImageUrl 图片水印URL String
watermarkTextContent 文本水印内容 String
watermarkFontSize 文字水印字号 String
watermarkDissolve 水印透明度 String

返回示例：

{
  "responseCode": "1",
  "responseMessage": "success",
  "data": {
    "companyUuid": "1cb9b911-62d9-4f68-a222-9c9f345b6ce6",
    "watermarkEnable": "true",
    "watermarkAlign": "SouthWest",
    "watermarkType": "TEXT",
    "watermarkImageUrl": "",
    "watermarkTextContent": "111",
    "watermarkFontSize": "0.3",
    "watermarkDissolve": "90"
  }
}

查询房源图片

请求方式：POST

请求地址：/api/marketingopenapi/commonhouse/listValidPropertyPhotoByUuids

  • 请求header中需要传"appId"
  • 通过uuids集合list获取房源图片信息(不包含删除的)

请求参数：

参数 描述 数据类型 必填 字段长度
uuids 房源photoUuid集合 List<String> 是 [1,200]

请求示例：

{
  "uuids": [
    "60ce1def-14ff-4b80-a8f8-e1b070b6b29e",
    "e0973745-f4cf-4684-ad76-b7096f493f1c"
  ]
}

返回参数：

参数 描述 数据类型 备注
photoUuid 图片uuid 不同公司此值唯一 String
externalPhotoUuid 图片uuid,不同公司此值不唯一, 和获取房源接口中picture 中 photoUuid对应 String
companyUuid 公司uuid String
propertyBaseUuid 公共营销房源UUID String
category 图片类型(1:INDOOR（室内图） 2:PLANS（户型图、平面图） 3:OUTDOOR（室外图） 其他：OTHER)； int
url 图片 url String
isCover 是否为封面图 0:否，1：是 String
imageType 户型图、卧室、厨房、客厅、卫生间、其他 等 String

返回示例：

{
  "data": [
    {
      "photoUuid": "60ce1def-14ff-4b80-a8f8-e1b070b6b29e",
      "companyUuid": "66996163-8b5f-474b-a757-b65e26500b15",
      "propertyBaseUuid": "5dca0e2a-ee88-4763-b189-b9a30df62ee7",
      "category": 3,
      "url": "//image.qfstatic.com/saas2_test2_company3_company7j8h6gh5tf/2020/04/20200409/51f95b8875c849318748960e1cf7a758.png",
      "isCover": 1,
      "imageType": 2
    },
    {
      "photoUuid": "e0973745-f4cf-4684-ad76-b7096f493f1c",
      "companyUuid": "66996163-8b5f-474b-a757-b65e26500b15",
      "propertyBaseUuid": "5dca0e2a-ee88-4763-b189-b9a30df62ee7",
      "category": 3,
      "url": "//image.qfstatic.com/saas2_test2_company3_company7j8h6gh5tf/2020/04/20200409/51f95b8875c849318748960e1cf7a758.png",
      "isCover": 1,
      "imageType": 2
    }
  ],
  "responseCode": "1",
  "responseMessage": "success"
}

查询房源标签

请求方式：POST

请求地址：/api/jediopenplatformopenapi/property/commonhouse/searchPropertyTag

  • 通过SaaS房源propertyUuids集合list获取房源标签(仅支持V20)

请求参数：

参数 描述 数据类型 必填 字段长度
param SaaS房源propertyUuids集合 List<String> 是 [1,200]

请求示例：

{
  "param": [
    "e463b90ee1b774ad4b89d2e94e40c954",
    "c36640b83c5ac2ddb1b82425b8a2e756"
  ]
}

返回参数：

参数 描述 数据类型 备注
data 房源列表 List<String>  

返回示例：

{
  "data": [
    {
      "propertyUuid": "e463b90ee1b774ad4b89d2e94e40c954",
      "tagList": [
        "钥匙",
        "满五"
      ]
    },
    {
      "propertyUuid": "c36640b83c5ac2ddb1b82425b8a2e756",
      "tagList": [
        "照片",
        "自定义标签一",
        "满二"
      ]
    }
  ],
  "responseCode": "1",
  "responseMessage": "success"
}

查询所有标签

请求方式：GET

请求地址：/api/jediopenplatformopenapi/property/commonhouse/searchAllTag

  • 查询SaaS系统所有标签(仅支持V20)

请求参数： 无

返回参数：

参数 描述 数据类型 备注
tagUuid 标签UUID String
tagName 标签名称 String  

返回示例：

{
  "data": [
    {
      "tagUuid": "propertyTag-qualityHouse-000000000000000",
      "tagName": "品质好房"
    },
    {
      "tagUuid": "propertyTag-indemnity-00000000000000",
      "tagName": "速销"
    },
    {
      "tagUuid": "propertyTag-exclusive-00000000000000",
      "tagName": "独家"
    },
    {
      "tagUuid": "propertyTag-hasKey-00000000000000000",
      "tagName": "钥匙"
    },
    {
      "tagUuid": "c446492ca39043639892bce8909b3ab8",
      "tagName": "自定义标签"
    }
  ],
  "responseCode": "1",
  "responseMessage": "success"
}

标签查询房源

请求方式：POST

请求地址：/api/jediopenplatformopenapi/property/commonhouse/searchPropertyByTag

  • 通过标签集合获取房源(仅支持V20)

请求参数：

参数 描述 数据类型 必填 备注
param 标签Uuids集合 List<String> 是 满N标签(purchaseTime-xxx) 和房源属性标签(proAttribute-xxx)查询是或查询, 其他标签是与查询

请求示例：

{
  "param": [
    "propertyTag-qualityHouse-000000000000000",
    "propertyTag-hasKey-00000000000000000",
    "c446492ca39043639892bce8909b3ab8"
  ],
  "page": {
    "pageNum": 1,
    "pageSize": 10
  }
}

返回参数：

参数 描述 数据类型 备注
items 房源UUID集合 List<String>  
count 总数 long  

返回示例：

{
  "data": {
    "items": [
      "c79d458db46143e093ca102793ce1b66",
      "2468575df08b4db39a33aa4709654278",
      "147b258fde3d4396b86a3f3c4c80e526",
      "edaf80876cd04ea9bd58f9b27a677ced",
      "1ab1512a35d440bfa6bb54f1c1fdea5b",
      "2baf12ed8c814159b764aeefb001d454",
      "7ae243d4a91446c2bd90f4edf49bf122",
      "82f239fc97eb475081182313b071d175",
      "8a22501cfc9b436eb31a86bd2d818d54",
      "1db2b260cfcc4de09eea20c558fbc0e0"
    ],
    "count": 1186
  },
  "responseCode": "1",
  "responseMessage": "success"
}

查询房源自定义字段值

请求方式：POST

请求地址：/api/jediopenplatformopenapi/property/commonhouse/searchPropertyCustomFieldVal

  • 通过SaaS房源uuid集合获取房源自定义字段值(仅支持V20)
  • 只返回设置过值的字段, 从而设置的字段不返回

请求参数：

参数 描述 数据类型 必填 备注
param SaaS房源Uuids集合 List<String> 是 集合大小不能超过200

请求示例：

{
  "param": [
    "15986498c9ae22a454cd509772677cb2",
    "6ae2504696a4798a96f1ea478bd865b2"
  ]
}

返回参数：

参数 描述 数据类型 备注
propertyUuid 房源uuid String
customizedFieldUuid 自定义字段uuid String
fieldName 自定义字段名称 String
fieldValue 自定义字段值 String  

返回示例：

{
  "data": [
    {
      "propertyUuid": "15986498c9ae22a454cd509772677cb2",
      "customizedFieldUuid": "7df0108a98693376491cfb5c4d9c0dc8",
      "fieldName": "测试字段1",
      "fieldValue": "11111"
    },
    {
      "propertyUuid": "15986498c9ae22a454cd509772677cb2",
      "customizedFieldUuid": "219cece2032c314540660ce4b151c395",
      "fieldName": "测试字段2",
      "fieldValue": "22222"
    },
    {
      "propertyUuid": "6ae2504696a4798a96f1ea478bd865b2",
      "customizedFieldUuid": "7df0108a98693376491cfb5c4d9c0dc8",
      "fieldName": "测试字段1",
      "fieldValue": "11111"
    },
    {
      "propertyUuid": "6ae2504696a4798a96f1ea478bd865b2",
      "customizedFieldUuid": "219cece2032c314540660ce4b151c395",
      "fieldName": "测试字段2",
      "fieldValue": "22222"
    }
  ],
  "responseCode": "1",
  "responseMessage": "success"
}

搜索公共营销库房源

请求方式：POST

请求地址：/api/marketingopenapi/commonhouse/searchProperty

请求参数：

参数名 描述 数据类型 必填 字节长度
pageDTO
pageNum 第几页 int 是
pageSize 每页条数 int 是
searchPropertyDTO
externalCompanyUuid 对接方(如:V20)公司uuid String 是 36
districtName 区域/县 String 否 100
areaName 商圈 String 否 255
estateName 楼盘名称 String 否 100
tradeType 交易类型
{
  RENT:出租（含租售）,
  SELL:出售（含租 ）
}		 String 是 10
room 户型（室），小于等于4室传对应数字，5室及以上传任何大于等于5的数字 Integer 否
minPrice 最低价格 Integer 否
maxPrice 最高价格 Integer 否
maxSquare 最大面积 Integer 否
startUpdateTime 起始时间(房源updatedTime) Date 否
endUpdateTime 结束时间(房源updatedTime) Date 否

请求示例：

{
  "pageDTO": {
    "pageNum": 1,
    "pageSize": 1
  },
  "searchPropertyDTO": {
    "areaName": "",
    "externalCompanyUuid": "saas2_test2_company3_company7j8h6gh5tf",
    "districtName": "",
    "estateName": "",
    "maxPrice": 1000,
    "maxSquare": 300,
    "minPrice": 0,
    "minSquare": 0,
    "room": 0,
    "tradeType": "RENT",
    "startUpdateTime": "2019-03-06 12:00:00",
    "endUpdateTime": "2019-11-06 12:00:00"
  }
}

返回参数：List

参数名 描述 数据类型 必填 字节长度
count 查询总数 int 是
items
propertyBaseUuid 唯一标示 String 是 36
companyUuid 营销系统给外部公司生成的内部公司uuid String 是 36
propertyNo 外部房源编号 String 是 100
propertyUuid 外部房源 uuid String 是 100
districtName 区域名称 String 否 100
estateName 楼盘名称 String 是 100
estateUuid 外部楼盘 uuid String 是 100
areaName 商圈名称 String 是 255
shi 室 Integer 否
ting 厅 Integer 否
wei 卫 Integer 否
floor 所在楼层 Integer 否
totalFloor 总楼层 Integer 否
square 面积 Float 否
direction 朝向：1东2南3西4北5东南6东北7西南8西北9南北10东西 Integer 否
completeYear 建造年代 Integer 否
decoration 装修情况：1毛坯2简单装修4精装修6高端装修 Integer 否
usageTypeId 用途：1普通住宅2别墅4公寓5平房6其他7新里洋房8老公房9四合院10排屋 String 否
tradeType 交易类型或状态（出售/出租） String 是
equityYear 房源标签（满N） String 否
price 出售价格 单位：元 Float 是
rentPrice 出租价格 单位：元 Float 否
employeeName 角色人名称（归属人1） String 否
picture 房源图片 String(json) 否
propertyDeleted 房源是否删除（0-false：房源有效[状态有效,审核通过，非封盘，非保护房]，1-true：房源无效或不开放） Boolean 是
hasKey 房源标签（是否有钥匙） Boolean 否
exclusive 房源标签（是否独家） Boolean 否
delegateTime 委托时间（挂牌时间） Date 否
longitude 经度 Double 否
latitude 纬度 Double 否
updatedTime 更新时间 Date 否
tradeStatus 状态（出租、出售） String 是
propertyCreatedTime 房源创建时间） String 是
propertyApprovedTime 房源审批通过时间 String 否
新增字段如下
address 详细地址 String 否 500
internalSquare 套内面积 bigDecimal 否 10(2)
kitchen 厨房：0、1、2、3、4、5、6、7、8、9 int 否 (单选)
balcony 阳台：0、1、2、3、4、5、6、7、8、9 int 否 (单选)
elevator 电梯 boolean 否
sellBasePrice 售底价 bigDecimal 否 16(2)
rentBasePrice 租底价 bigDecimal 否 16(2)
rentType 租房方式（1，整租，2,合租） int 否 (单选)
paymentTerms 付款方式（1：付1押1 2：付1押2 3：付2押1 4：付2押2 5：付3押1 6：付3押2 7：面议 8：半年付 9：年付 10：半年付押1 11：半年付不押 12：年付不押 13：年付押1 14：其他） int 否 (单选)
independFacilities 出租房屋配套:1，冰箱,2，电视,3，洗衣机,4，热水器,5，空调,6，宽带,7，沙发,8，床（ 独）, 9，暖气,10，衣柜,11，可做饭,12，卫生间,13，阳台,14，天燃气，15，椅子，16，桌子，17，微波炉，18，电风扇，19，其他 String 否(多选) 100
rentPriceInclude 费用是否包含在月租（水费、电费、燃气费、宽带费、暖气费、物业费） String 否(多选) 20
rentExpireTime 租约到期时间 Date 否
grade 等级：A（急迫）；B（较强）；C（一般）；D（较弱）；E（暂不关注）；F（其他） String 否（单选）
propertyEquityYear 房本年限 ：3,不满两年、2,满两年、1,满五年 String 否（单选）
buyTime 购买日期 Date 否
sellCause 售房原因 String 否 200
onlyHouse 唯一住房 boolean 否 200
credit 有无贷款 boolean 否 200
creditRemark 贷款说明：数字，若有贷款，显示贷款金额：x万元；若无贷款，显示贷款金额：0万元 String 否 255
delegateType 委托方式：1,独家、2,一般委托、3,签赔、4,包租、5,托管、6,收购、7,其他 String 否 255
handOverDate 交房日期 Date 否 200
recordNo 备案号 String 否 30
consignRemark 交房备注 String 否 50
consignStartDate 委托开始时间 Date 否
consignEndDate 委托结束时间 Date 否
remark 房源备注 String 否 不限
occupancy 房屋现状：1,业主自住、2,空置、3,客租住、4,已售出、5,其他 String 否
equityType 产权类型：1,商品房、5,售后公房、3,经济适用房、4,保障性住房、2,配套商品房、6,军产房、7,动迁安 置房、8,其他 String 否
taxType 包税费:1,各付、2,到手、3,包税、4,其他 String 否
supportFacilities 配套房屋设施：1，冰箱,2，电视,3，洗衣机,4，热水器,5，空调,6，宽带,7，沙发,8，床 （独）,9，暖气,10，衣柜,11，可做饭,12，卫生间,13，阳台,14，天燃气，15，椅子，16，桌子，17，微波炉，18，电风扇，19，其他 String 否（多选） 100
managementFee 管理费 String 否 25
park 有无车位 boolean 否
parkType 1,地上车位、2,地下车位、3,其他 String 否
buyPaymentType 购房付款方式：1,一次付清、2,按揭方式、3,资垫解按、4,其他 String 否 200
propertyRightYear 产权年限 ：1,70年、2,50年、3,40年,4,永久产权 String 否 50
descriptionTitle 描述标题 String 否 50
propertyDesc 房源描述 String 否 1000
environment 周边信息:周边小区配套等说明，文本 String 否 1000
以下为新增字段（政府核验码相关），后期分类上去
consignCode 委托编码（0827） String 否 400
verifyCode 房源核验码（备案编号）（0827） String 否 400
verifyQrCode 房源核验二维码（哈尔滨、常熟必填）（0827） String 否 400
以下为调整字段（真房优品），后期分类上去
propertyLabel 标签 优质房（笋盘）：2 聚焦房：4 速销房：8、 如：优质房（2）+聚焦房（4）= 6 （0827） Integer 否 200
返回参数（房源图片）
参数 参数说明 类型
category 图片类型(1:INDOOR（室内图） 2:PLANS（户型图、平面图） 3:OUTDOOR（室外图） 其他：OTHER)； Integer
imageType 户型图、卧室、厨房、客厅、卫生间、其他 等 String
photoUuid 图片 uuid String
url 图片 url String
isCover 是否为封面图{0:否，1：是} Integer
watermarkAlign SouthEast等 图片水印位置 枚举
watermarkImageUrl 水印图片 String

返回示例：

{
    "responseCode": "1",
    "responseMessage": "success",
    "responseType": null,
    "data": {
        "list": [{
            "propertyBaseUuid": "37620bdb-edee-4e46-a931-9de518a7d774",
            "companyUuid": "62557853-a223-489a-a144-d675210227d1",
            "propertyNo": "8120690C5F37B",
            "propertyUuid": "ff5e80ecea1743dca0669847d344cc7b",
            "districtName": "浦东新区",
            "areaName": "张江",
            "estateName": "孙桥路428弄",
            "estateUuid": "e78834ad648848a39aaf6b60724a967b",
            "shi": 4,
            "ting": 3,
            "wei": 2,
            "floor": 1,
            "totalFloor": 18,
            "square": 200.0,
            "direction": 5,
            "completeYear": 2000,
            "decoration": 4,
            "usageTypeId": 1,
            "tradeType": "租售",
            "equityYear": "5",
            "price": 5660000.0,
            "rentPrice": 4000.0,
            "employeeName": "张辰2",
            "employeeUuid": "fbfa795f-3146-41ef-a131-38b136a8fe58",
            "picture": "[{\"category\":1,\"imageType\":\"卫生间\",\"isCover\":0,\"photoUuid\":\"9786b2ea-fb11-487a-8445-423b1a7b99ba\",\"url\":\"//image.qfstatic.com/saas2_test_company3_company7j8h6gh5tf/2019/04/20190424/288ebc77458f49469cb96e837c55bac4.jpg\",\"watermarkAlign\":\"SouthEast\",\"watermarkImageUrl\":\"//image.qfstatic.com/saas2_test_company3_company7j8h6gh5tf/2018/12/20181204/e2e39df7362e4c48b9dfcc856da6d1d4.png\"}]",
            "propertyDeleted": false,
            "hasKey": false,
            "exclusive": false,
            "delegateTime": 1545210912000,
            "longitude": null,
            "latitude": null,
            "updatedTime": 1577287104000,
            "tradeStatus": "租售",
            "propertyCreatedTime": 1544084705000,
            "propertyApprovedTime": null,
            "address": null,
            "internalSquare": 180.00,
            "kitchen": null,
            "balcony": null,
            "elevator": null,
            "sellBasePrice": null,
            "rentBasePrice": null,
            "rentType": null,
            "paymentTerms": null,
            "independFacilities": null,
            "rentPriceInclude": null,
            "rentExpireTime": null,
            "grade": null,
            "propertyEquityYear": 1,
            "buyTime": null,
            "sellCause": null,
            "onlyHouse": false,
            "credit": null,
            "creditRemark": null,
            "delegateType": null,
            "handOverDate": null,
            "recordNo": null,
            "consignRemark": null,
            "consignStartDate": null,
            "consignEndDate": null,
            "propertyLabel": null,
            "remark": null,
            "occupancy": 1,
            "equityType": null,
            "taxType": null,
            "supportFacilities": null,
            "managementFee": null,
            "park": null,
            "parkType": null,
            "buyPaymentType": null,
            "certificationNo": null,
            "propertyRightYear": null,
            "descriptionTitle": null,
            "propertyDesc": null,
            "environment": null
        }],
        "count": 41
    }
}

results matching ""

    No results matching ""