查询房源全部角色人

请求方式：POST

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

  • 根据SaaS房源UUID查询房源全部角色人信息(相关方)（不包含删除的)
  • 入参中房源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 SaaS员工电话

返回示例：

{
  "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/jediopenplatformopenapi/property/commonhouse/searchPropertyTag

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

请求参数：

参数 描述 数据类型 必填 字段长度
param 房源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

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

请求参数：

参数 描述 数据类型 必填 备注
param 房源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/jediopenplatformopenapi/property/commonhouse/getPropertyMainInfoAddress

  • 通过房源uuid集合获取房源地址(仅支持V20)

请求参数：

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

请求示例：

{
  "param": [
    "55be55bec3ef423dbb99159d24e38aae",
    "45be55bec3ef423dbb99159d24e38aae"
  ]
}

返回参数：

参数 描述 数据类型 备注
propertyUuid 房源uuid String
estateName 楼盘 String
buildingName 栋座 String
unitName 单元 String  
roomNo 房号 String  

返回示例：

{
  "data": [
    {
      "propertyUuid": "55be55bec3ef423dbb99159d24e38aae",
      "estateName": "晶耀名邸-住宅",
      "buildingName": "3",
      "unitName": null,
      "roomNo": "0201"
    },
    {
      "propertyUuid": "45be55bec3ef423dbb99159d24e38aae",
      "estateName": "晶耀名邸-住宅",
      "buildingName": "4",
      "unitName": null,
      "roomNo": "0401"
    }
  ],
  "responseCode": "1",
  "responseMessage": "success"
}

results matching ""

    No results matching ""