查询房源全部角色人

请求方式：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/searchPropertyFollow

  • 分页查询，房源Uuid集合最大20，页面大小（pageSize）不超过1000

请求参数：

参数 描述 数据类型 必填 备注
propertyUuids SaaS房源Uuid集合 Array<String> 否 uuid集合长度最多20个

请求示例：

{
  "page": {
    "pageNum": 1,
    "pageSize": 20
  },
  "param": {
    "propertyUuids": [
      "546c482f3f9743b888ab4c13519b4063",
      "0cef7a549c5a44db87238fffde402034"
    ]
  }
}

返回参数：

name type desc
responseCode string
responseMessage string
responseType string
errorDataMap object
  |─key object
data array
  |─ object
    |─followUuid string 跟进uuid
    |─propertyUuid string 房源uuid
    |─propertyNo string 房源编号
    |─deptUuid string 跟进人部门uuid
    |─deptName string 跟进人部门名称
    |─employeeUuid string 跟进人uuid
    |─employeeName string 跟进人姓名
    |─employeeNo string 跟进人工号
    |─contents string 跟进内容
    |─followCreatedTime string 跟进时间
    |─callRecordUuid string 话单uuid
    |─recordList array 录音信息列表
      |─ object
        |─telRecordUniqueId string 话单Uuid
        |─telRecordUuid string 录音Uuid
        |─recordUrl string 录音地址

返回示例：


{
  "responseCode": "1",
  "responseMessage": "success",
  "responseType": null,
  "data": [
    {
      "followUuid": "0634fce5cb984ff586d41beaf619dc07",
      "propertyUuid": "546c482f3f9743b888ab4c13519b4063",
      "propertyNo": "8030285988B96",
      "deptUuid": "99",
      "deptName": "系统管理组",
      "employeeUuid": "e6efc671-db59-4b25-8440-a91719242562",
      "employeeName": "刘小米",
      "employeeNo": "231038",
      "contents": null,
      "followCreatedTime": 1766370043708,
      "callRecordUuid": "e57c0250-10d8-4dd7-916d-fefcbb668ad8",
      "recordList": [
        {
          "telRecordUniqueId": "e57c0250-10d8-4dd7-916d-fefcbb668ad8",
          "telRecordUuid": "e57c0250-10d8-4dd7-916d-fefcbb668ad8",
          "recordUrl": "https://cdntestv5.58v5.cn/EGfGAZyXwEGhf/sipaudiosource-d91479e9/34411111119942.mp3"
        }
      ]
    },
    {
      "followUuid": "e643d1a025b649288eba4d812ec25898",
      "propertyUuid": "546c482f3f9743b888ab4c13519b4063",
      "propertyNo": "8030285988B96",
      "deptUuid": "99",
      "deptName": "系统管理组",
      "employeeUuid": "e6efc671-db59-4b25-8440-a91719242562",
      "employeeName": "刘小米",
      "employeeNo": "231038",
      "contents": null,
      "followCreatedTime": 1766369409422,
      "callRecordUuid": "e7258205-c7d6-4411-9ef8-a8d1baa59249",
      "recordList": [
        {
          "telRecordUniqueId": "e7258205-c7d6-4411-9ef8-a8d1baa59249",
          "telRecordUuid": "e7258205-c7d6-4411-9ef8-a8d1baa59249",
          "recordUrl": "https://cdntestv5.58v5.cn/EGfGAZyXwEGhf/sipaudiosource-b4c89bac/344011111118341.mp3"
        }
      ]
    },
    {
      "followUuid": "75b9c8fc1f4040faafd3816ebe81df33",
      "propertyUuid": "546c482f3f9743b888ab4c13519b4063",
      "propertyNo": "8030285988B96",
      "deptUuid": "99",
      "deptName": "系统管理组",
      "employeeUuid": "e6efc671-db59-4b25-8440-a91719242562",
      "employeeName": "刘小米",
      "employeeNo": "231038",
      "contents": null,
      "followCreatedTime": 1766369353999,
      "callRecordUuid": "a111ad41-42cc-409d-893f-2bf106af12a4",
      "recordList": [
        {
          "telRecordUniqueId": "a111ad41-42cc-409d-893f-2bf106af12a4",
          "telRecordUuid": "a111ad41-42cc-409d-893f-2bf106af12a4",
          "recordUrl": "https://cdntestv5.58v5.cn/EGfGAZyXwEGhf/sipaudiosource-b8a571cd/34401111119665.mp3"
        }
      ]
    },
    {
      "followUuid": "d1299df79bf34cd7b243d9e4950ed1dc",
      "propertyUuid": "546c482f3f9743b888ab4c13519b4063",
      "propertyNo": "8030285988B96",
      "deptUuid": "99",
      "deptName": "系统管理组",
      "employeeUuid": "e6efc671-db59-4b25-8440-a91719242562",
      "employeeName": "刘小米",
      "employeeNo": "231038",
      "contents": null,
      "followCreatedTime": 1766369116538,
      "callRecordUuid": "f34b88f0-b227-488f-a94c-211790a44c98",
      "recordList": [
        {
          "telRecordUniqueId": "f34b88f0-b227-488f-a94c-211790a44c98",
          "telRecordUuid": "f34b88f0-b227-488f-a94c-211790a44c98",
          "recordUrl": "https://cdntestv5.58v5.cn/EGfGAZyXwEGhf/sipaudiosource-02c0bedc/3440111111384437.mp3"
        }
      ]
    },
    {
      "followUuid": "f46b13d07e7d41a889bfb4e6725f0da7",
      "propertyUuid": "546c482f3f9743b888ab4c13519b4063",
      "propertyNo": "8030285988B96",
      "deptUuid": "99",
      "deptName": "系统管理组",
      "employeeUuid": "e6efc671-db59-4b25-8440-a91719242562",
      "employeeName": "刘小米",
      "employeeNo": "231038",
      "contents": null,
      "followCreatedTime": 1766369078022,
      "callRecordUuid": "37aaf098-e657-4f71-9223-bc045bfbfa53",
      "recordList": [
        {
          "telRecordUniqueId": "37aaf098-e657-4f71-9223-bc045bfbfa53",
          "telRecordUuid": "37aaf098-e657-4f71-9223-bc045bfbfa53",
          "recordUrl": "https://cdntestv5.58v5.cn/EGfGAZyXwEGhf/sipaudiosource-37cdc207/3440111111166931.mp3"
        }
      ]
    },
    {
      "followUuid": "3b52e9e34fd24a64904c2208bd19b9d3",
      "propertyUuid": "546c482f3f9743b888ab4c13519b4063",
      "propertyNo": "8030285988B96",
      "deptUuid": "1f344e64d47b4a13981b70fbafa26aca",
      "deptName": "CLL-01",
      "employeeUuid": "9999",
      "employeeName": "系统管理员",
      "employeeNo": "999999",
      "contents": "呵呵叫姐姐你你你",
      "followCreatedTime": 1766142653336,
      "callRecordUuid": "d5e71c06-05ec-4ece-afd5-674088231667",
      "recordList": [
        {
          "telRecordUniqueId": "d5e71c06-05ec-4ece-afd5-674088231667",
          "telRecordUuid": "d5e71c06-05ec-4ece-afd5-674088231667",
          "recordUrl": "https://cdntestv5.58v5.cn/EGfGAZyXwEGhf/sipaudiosource-aab935de/34391111111906357.mp3"
        }
      ]
    },
    {
      "followUuid": "bd105acb9f5b4f33a624d15495d22e07",
      "propertyUuid": "546c482f3f9743b888ab4c13519b4063",
      "propertyNo": "8030285988B96",
      "deptUuid": "99",
      "deptName": "系统管理组",
      "employeeUuid": "e6efc671-db59-4b25-8440-a91719242562",
      "employeeName": "刘小米",
      "employeeNo": "231038",
      "contents": null,
      "followCreatedTime": 1766140399045,
      "callRecordUuid": "e5a465d4-762f-4620-9e68-2286a100c159",
      "recordList": [
        {
          "telRecordUniqueId": "e5a465d4-762f-4620-9e68-2286a100c159",
          "telRecordUuid": "e5a465d4-762f-4620-9e68-2286a100c159",
          "recordUrl": "https://cdntestv5.58v5.cn/EGfGAZyXwEGhf/sipaudiosource-b667dcbe/343111111181201.mp3"
        }
      ]
    },
    {
      "followUuid": "33984e82d396454494f5ac3ff8a1f032",
      "propertyUuid": "546c482f3f9743b888ab4c13519b4063",
      "propertyNo": "8030285988B96",
      "deptUuid": "99",
      "deptName": "系统管理组",
      "employeeUuid": "e6efc671-db59-4b25-8440-a91719242562",
      "employeeName": "刘小米",
      "employeeNo": "231038",
      "contents": null,
      "followCreatedTime": 1766138917288,
      "callRecordUuid": "4b52d720-2586-4d5d-a0e5-157c0a51dd7e",
      "recordList": [
        {
          "telRecordUniqueId": "4b52d720-2586-4d5d-a0e5-157c0a51dd7e",
          "telRecordUuid": "4b52d720-2586-4d5d-a0e5-157c0a51dd7e",
          "recordUrl": "https://cdntestv5.58v5.cn/EGfGAZyXwEGhf/sipaudiosource-e4dc1e4b/343951111118006985.mp3"
        }
      ]
    },
    {
      "followUuid": "236e99a98adb4d2ba651fc3dbcab4188",
      "propertyUuid": "546c482f3f9743b888ab4c13519b4063",
      "propertyNo": "8030285988B96",
      "deptUuid": "99",
      "deptName": "系统管理组",
      "employeeUuid": "e6efc671-db59-4b25-8440-a91719242562",
      "employeeName": "刘小米",
      "employeeNo": "231038",
      "contents": null,
      "followCreatedTime": 1766138843987,
      "callRecordUuid": "17460e3a-7570-4508-aebe-57d3dffcc920",
      "recordList": [
        {
          "telRecordUniqueId": "17460e3a-7570-4508-aebe-57d3dffcc920",
          "telRecordUuid": "17460e3a-7570-4508-aebe-57d3dffcc920",
          "recordUrl": "https://cdntestv5.58v5.cn/EGfGAZyXwEGhf/sipaudiosource-a960e6ac/3439111111199548.mp3"
        }
      ]
    },
    {
      "followUuid": "f8faf8c2607340dfab1887c252fddfb2",
      "propertyUuid": "546c482f3f9743b888ab4c13519b4063",
      "propertyNo": "8030285988B96",
      "deptUuid": "1f344e64d47b4a13981b70fbafa26aca",
      "deptName": "CLL-01",
      "employeeUuid": "9999",
      "employeeName": "系统管理员",
      "employeeNo": "999999",
      "contents": "1.税费情况：\n2.购房付款方式：\n3.贷款情况：\n4.联系人是否是产权人：\n5.学区情况：\n6.户口情况：",
      "followCreatedTime": 1766137577430,
      "callRecordUuid": "fe4d9901-b9cb-4c61-859f-9da5ffde0bce",
      "recordList": []
    },
    {
      "followUuid": "dab17313f92c4e64afb80cd4a62df536",
      "propertyUuid": "546c482f3f9743b888ab4c13519b4063",
      "propertyNo": "8030285988B96",
      "deptUuid": "99",
      "deptName": "系统管理组",
      "employeeUuid": "e6efc671-db59-4b25-8440-a91719242562",
      "employeeName": "刘小米",
      "employeeNo": "231038",
      "contents": null,
      "followCreatedTime": 1766135809812,
      "callRecordUuid": "7f1da23a-71a8-41e9-adb2-22cc5494476c",
      "recordList": [
        {
          "telRecordUniqueId": "7f1da23a-71a8-41e9-adb2-22cc5494476c",
          "telRecordUuid": "7f1da23a-71a8-41e9-adb2-22cc5494476c",
          "recordUrl": "https://cdntestv5.58v5.cn/EGfGAZyXwEGhf/sipaudiosource-c12e9fdf/3439111111138762.mp3"
        }
      ]
    },
    {
      "followUuid": "9b97f970d3b3468f9a42d05169ed30f8",
      "propertyUuid": "546c482f3f9743b888ab4c13519b4063",
      "propertyNo": "8030285988B96",
      "deptUuid": "99",
      "deptName": "系统管理组",
      "employeeUuid": "953b88b2-6558-4346-8978-ef7a7f3fc81e",
      "employeeName": "张章长",
      "employeeNo": " 215",
      "contents": "巴啦啦啦斤斤计较斤斤计较，",
      "followCreatedTime": 1766133897923,
      "callRecordUuid": "5b8b930e-3527-499b-a91a-f2cf211aade3",
      "recordList": [
        {
          "telRecordUniqueId": "5b8b930e-3527-499b-a91a-f2cf211aade3",
          "telRecordUuid": "5b8b930e-3527-499b-a91a-f2cf211aade3",
          "recordUrl": ""
        }
      ]
    },
    {
      "followUuid": "72657dae1c184523982afb535fce4625",
      "propertyUuid": "546c482f3f9743b888ab4c13519b4063",
      "propertyNo": "8030285988B96",
      "deptUuid": "99",
      "deptName": "系统管理组",
      "employeeUuid": "568d0057-5e72-47e1-8323-d2c86ff850de",
      "employeeName": "沈博宇",
      "employeeNo": "234512",
      "contents": null,
      "followCreatedTime": 1766132965098,
      "callRecordUuid": "88166c4a-063b-4bcd-81d9-a22d5cf1eb48",
      "recordList": []
    },
    {
      "followUuid": "0d8b36bfb43c4ed187fb5632fe4e3dcc",
      "propertyUuid": "546c482f3f9743b888ab4c13519b4063",
      "propertyNo": "8030285988B96",
      "deptUuid": "99",
      "deptName": "系统管理组",
      "employeeUuid": "e6efc671-db59-4b25-8440-a91719242562",
      "employeeName": "刘小米",
      "employeeNo": "231038",
      "contents": null,
      "followCreatedTime": 1766051641189,
      "callRecordUuid": "12f0e6db-1427-48ae-afc5-6ba48737179a",
      "recordList": [
        {
          "telRecordUniqueId": "12f0e6db-1427-48ae-afc5-6ba48737179a",
          "telRecordUuid": "12f0e6db-1427-48ae-afc5-6ba48737179a",
          "recordUrl": "https://cdntestv5.58v5.cn/EGfGAZyXwEGhf/sipaudiosource-1e18e566/343921111111843594.mp3"
        }
      ]
    },
    {
      "followUuid": "1ea7d61c553645369ee9652a5db70426",
      "propertyUuid": "546c482f3f9743b888ab4c13519b4063",
      "propertyNo": "8030285988B96",
      "deptUuid": "99",
      "deptName": "系统管理组",
      "employeeUuid": "e6efc671-db59-4b25-8440-a91719242562",
      "employeeName": "刘小米",
      "employeeNo": "231038",
      "contents": null,
      "followCreatedTime": 1766051602497,
      "callRecordUuid": "21c6abb9-0ad5-4aa5-bba1-399c827c344c",
      "recordList": [
        {
          "telRecordUniqueId": "21c6abb9-0ad5-4aa5-bba1-399c827c344c",
          "telRecordUuid": "21c6abb9-0ad5-4aa5-bba1-399c827c344c",
          "recordUrl": ""
        }
      ]
    },
    {
      "followUuid": "6a12384470444cf7a1d2d28a93856a4d",
      "propertyUuid": "546c482f3f9743b888ab4c13519b4063",
      "propertyNo": "8030285988B96",
      "deptUuid": "99",
      "deptName": "系统管理组",
      "employeeUuid": "e6efc671-db59-4b25-8440-a91719242562",
      "employeeName": "刘小米",
      "employeeNo": "231038",
      "contents": null,
      "followCreatedTime": 1766049287054,
      "callRecordUuid": "a4b930bf-a495-4df9-8336-fe9154a781ad",
      "recordList": [
        {
          "telRecordUniqueId": "a4b930bf-a495-4df9-8336-fe9154a781ad",
          "telRecordUuid": "a4b930bf-a495-4df9-8336-fe9154a781ad",
          "recordUrl": "https://cdntestv5.58v5.cn/EGfGAZyXwEGhf/sipaudiosource-20cd6b8c/34392111111798924.mp3"
        }
      ]
    },
    {
      "followUuid": "c9a330497424422689fa7639e31462c0",
      "propertyUuid": "546c482f3f9743b888ab4c13519b4063",
      "propertyNo": "8030285988B96",
      "deptUuid": "99",
      "deptName": "系统管理组",
      "employeeUuid": "e6efc671-db59-4b25-8440-a91719242562",
      "employeeName": "刘小米",
      "employeeNo": "231038",
      "contents": null,
      "followCreatedTime": 1766045844067,
      "callRecordUuid": "f868538b-3923-4ae0-8681-daeb780f26b6",
      "recordList": [
        {
          "telRecordUniqueId": "f868538b-3923-4ae0-8681-daeb780f26b6",
          "telRecordUuid": "f868538b-3923-4ae0-8681-daeb780f26b6",
          "recordUrl": "https://cdntestv5.58v5.cn/EGfGAZyXwEGhf/sipaudiosource-287beea5/343918111158009.mp3"
        }
      ]
    },
    {
      "followUuid": "ee08f76ffaad46be90f982fdd02150ce",
      "propertyUuid": "546c482f3f9743b888ab4c13519b4063",
      "propertyNo": "8030285988B96",
      "deptUuid": "99",
      "deptName": "系统管理组",
      "employeeUuid": "568d0057-5e72-47e1-8323-d2c86ff850de",
      "employeeName": "沈博宇",
      "employeeNo": "234512",
      "contents": "1.税费情况：\n2.购房付款方式：\n3.贷款情况：\n4.联系人是否是产权人：\n5.学区情况：\n6.户口情况：",
      "followCreatedTime": 1766028545457,
      "callRecordUuid": "7080707f-53d1-4e95-bc31-cd51bf886d9d",
      "recordList": []
    },
    {
      "followUuid": "72b94fb0fb6b47e880ccc8352ea8e44f",
      "propertyUuid": "546c482f3f9743b888ab4c13519b4063",
      "propertyNo": "8030285988B96",
      "deptUuid": "99",
      "deptName": "系统管理组",
      "employeeUuid": "568d0057-5e72-47e1-8323-d2c86ff850de",
      "employeeName": "沈博宇",
      "employeeNo": "234512",
      "contents": "fffff1.税费情况：\n2.购房付款方式：\n3.贷款情况：\n4.联系人是否是产权人：\n5.学区情况：\n6.户口情况：",
      "followCreatedTime": 1766028319602,
      "callRecordUuid": "8dfde9c8-123c-48f6-8366-91cac7e89585",
      "recordList": []
    },
    {
      "followUuid": "140eebfea8424667b7cee7fcfb197866",
      "propertyUuid": "546c482f3f9743b888ab4c13519b4063",
      "propertyNo": "8030285988B96",
      "deptUuid": "99",
      "deptName": "系统管理组",
      "employeeUuid": "568d0057-5e72-47e1-8323-d2c86ff850de",
      "employeeName": "沈博宇",
      "employeeNo": "234512",
      "contents": "1.税费情况：\n2.购房付款方式：\n3.贷款情况：\n4.联系人是否是产权人：\n5.学区情况：\n6.户口情况：",
      "followCreatedTime": 1765958781508,
      "callRecordUuid": "61d33ba9-6b99-4014-85d2-f7a39ea2edcf",
      "recordList": []
    }
  ]
}

查询房源标签

请求方式：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"
}

查询业主信息（需协议）

请求方式：POST

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

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

请求参数：

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

请求示例：

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

返回参数：

参数 描述 数据类型 备注
propertyUuid 房源uuid String
propertyNo 房源编号 String
name 联系人名称 String
phone1 电话1，字段支持加密传输，遵循开放平台加解密算法，加解密密钥同公司授权密钥，即appSecret String  
phone2 电话2，字段支持加密传输，遵循开放平台加解密算法，加解密密钥同公司授权密钥，即appSecret String  

返回示例：

{
  "responseCode": "1",
  "responseMessage": "success",
  "responseType": null,
  "data": [
    {
      "propertyUuid": "546c482f3f9743b888ab4c13519b4063",
      "propertyNo": "8030285988B96",
      "name": "张子瑜",
      "phone1": "enc:FgWBLks83O0CV4VbzIfpQg==",
      "phone2": ""
    },
    {
      "propertyUuid": "546c482f3f9743b888ab4c13519b4063",
      "propertyNo": "8030285988B96",
      "name": "刘紫玉",
      "phone1": "enc:laYfgWRXYMNMnsOWp4zMnA==",
      "phone2": ""
    },
    {
      "propertyUuid": "546c482f3f9743b888ab4c13519b4063",
      "propertyNo": "8030285988B96",
      "name": "谭都德",
      "phone1": "enc:UpZtPETXZVd0vvDhhoD+UA==",
      "phone2": null
    },
    {
      "propertyUuid": "546c482f3f9743b888ab4c13519b4063",
      "propertyNo": "8030285988B96",
      "name": "Jimmy",
      "phone1": "enc:/Cjm3z3r7Njsbstvve/Uhw==",
      "phone2": ""
    },
    {
      "propertyUuid": "f4aad056141c49f0bf199c597c1e12ae",
      "propertyNo": "80928C808DA8C",
      "name": "星业主003",
      "phone1": "enc:dKmS9d0kdVuEdNp+VN9Kwg==",
      "phone2": null
    },
    {
      "propertyUuid": "546c482f3f9743b888ab4c13519b4063",
      "propertyNo": "8030285988B96",
      "name": "1234",
      "phone1": "enc:aosdjX1vVmxdg4KJ4+UJxw==",
      "phone2": "enc:R2PdaMnWkU5jyPwcz+Q7Vg=="
    }
  ]
}

查询委托信息（需协议）

请求方式：POST

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

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

请求参数：

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

请求示例：

{
  "param": [
    "0f3ad5d57ce44ceeb213aea451974e63",
    "a762ff11bfbb49029790a9dbc3349c5f",
    "df7d776645b14005b3ef319bc6f3ac5d"
  ]
}

返回参数：

name type desc
responseCode string
responseMessage string
responseType string
errorDataMap object
  |─key object
data array
  |─ object
    |─propertyUuid string 房源Uuid
    |─entrustUuid string 委托Uuid
    |─entrustType string 委托类型
    |─entrustTypeName string 委托类型-名称
    |─entrustStatus string 委托状态
    |─entrustStatusName string 委托状态-名称
    |─entrustBeginTime string 委托开始时间
    |─entrustEndTime string 委托结束时间
    |─realEndTime string 真实结束时间
    |─entrustCreatedTime string 委托创建时间
    |─entrustNo string 委托编号
    |─entrustEmpUuid string 委托人Uuid
    |─entrustEmpName string 委托人姓名
    |─entrustEmpNo string 委托人工号
    |─entrustDeptUuid string 委托人部门Uuid
    |─entrustDeptName string 委托人部门名称
    |─propertyOwner string 房源产权人
    |─propertyOwnerPhone string 产权人电话。字段支持加密传输，遵循开放平台加解密算法，加解密密钥同公司授权密钥，即appSecret
    |─createdTime string 创建时间
    |─esignContractUrl string 电子合同地址-有效时间30分钟
    |─miniAppContractUrl string 小程序合同地址
    |─subSignType string 签约方式
    |─subSignTypeName string 签约方式-名称
    |─affixVOList array 附件列表
      |─ object
        |─entrustAffixUuid string 附件Uuid
        |─entrustUuid string 委托Uuid
        |─attachmentType string 附件类型
        |─attachmentTypeName string 附件类型-名称
        |─affixUrl string 附件URL
        |─formatType string 文件格式
        |─createdTime string 创建时间
    |─contractNo string 合同编号

返回示例：

{
  "responseCode": "1",
  "responseMessage": "success",
  "responseType": null,
  "data": [
    {
      "propertyUuid": "0f3ad5d57ce44ceeb213aea451974e63",
      "entrustUuid": "82af181390ae451e80d6a310eda74fce",
      "entrustType": "saleType",
      "entrustTypeName": "一般售委托",
      "entrustStatus": "passBegin",
      "entrustStatusName": "委托中",
      "entrustBeginTime": 1764777600000,
      "entrustEndTime": 1767196799998,
      "realEndTime": null,
      "entrustCreatedTime": 1764835602591,
      "entrustNo": "YBS202512041606429168",
      "entrustEmpUuid": "52ee3425-6265-4205-aa45-49845cc76584",
      "entrustEmpName": "赫敏",
      "entrustEmpNo": "334423",
      "entrustDeptUuid": "675fa4f8cc88478384d8ff340988f023",
      "entrustDeptName": "维护人片区",
      "propertyOwner": "李一一",
      "propertyOwnerPhone": "enc:Vo1QWpJB2MbHe1++4lan5Q==",
      "createdTime": 1764835602591,
      "esignContractUrl": null,
      "miniAppContractUrl": null,
      "subSignType": "offline",
      "subSignTypeName": "线下签约",
      "affixVOList": [
        {
          "entrustAffixUuid": "09d7e29cc0bc40689aeed9674d69318d",
          "entrustUuid": "82af181390ae451e80d6a310eda74fce",
          "attachmentType": "agreement",
          "attachmentTypeName": "委托协议",
          "affixUrl": "https://image.qfstatic.com/V20ceshishangxianmao_saas2_88a1796ee/fang_entrust/2025/12/4/7a81ef1e93c47bab53587c8.png",
          "formatType": "image/png",
          "createdTime": 1764835602552
        },
        {
          "entrustAffixUuid": "02066f936fa74f3e92f54abcbd1b6160",
          "entrustUuid": "82af181390ae451e80d6a310eda74fce",
          "attachmentType": "idCard",
          "attachmentTypeName": "产权人身份证",
          "affixUrl": "https://image.qfstatic.com/V20ceshishangxianmao_saas2_88a1796ee/fang_entrust/2025/12/4/35e8d6ae726f4b2231fc75b.jpg",
          "formatType": "image/jpeg",
          "createdTime": 1764835602552
        }
      ],
      "contractNo": null
    },
    {
      "propertyUuid": "df7d776645b14005b3ef319bc6f3ac5d",
      "entrustUuid": "7b5278fdc8144f71a134ded2de84bd8b",
      "entrustType": "exclusiveSaleType",
      "entrustTypeName": "独家售委托",
      "entrustStatus": "passBegin",
      "entrustStatusName": "委托中",
      "entrustBeginTime": 1762704000000,
      "entrustEndTime": 1762790399998,
      "realEndTime": 1762790399998,
      "entrustCreatedTime": 1762758244570,
      "entrustNo": "DJS202511101502499734",
      "entrustEmpUuid": "43368d2f-61f0-4122-a639-80296dea1d53",
      "entrustEmpName": "蔡子子",
      "entrustEmpNo": "223456",
      "entrustDeptUuid": "1534416d0f2e42f18b45792bf8a273e2",
      "entrustDeptName": "crmfangwebtest4",
      "propertyOwner": "王一一",
      "propertyOwnerPhone": "enc:hgvtPWXi8leE6CKP+YNE3Q==",
      "createdTime": 1762758244570,
      "esignContractUrl": null,
      "miniAppContractUrl": "https://image.qfstatic.com/FgPv_xvSkei-CyrG5D7NxKeNJ-",
      "subSignType": "miniApp",
      "subSignTypeName": "小程序签约",
      "affixVOList": [
        {
          "entrustAffixUuid": "cd5ac3c25198455ca003efadcf25dc13",
          "entrustUuid": "7b5278fdc8144f71a134ded2de84bd8b",
          "attachmentType": "idCard",
          "attachmentTypeName": "产权人身份证",
          "affixUrl": "https://image.qfstatic.com/V20ceshishangxiaas2_88a1796ee/image/2025/11/10/1762758155914/6a23e6c7-718eb7-53aeb93faf84.jpg",
          "formatType": "image/jpeg",
          "createdTime": 1762758169113
        },
        {
          "entrustAffixUuid": "27c02b5bdfa04004b0ac227c62431cb1",
          "entrustUuid": "7b5278fdc8144f71a134ded2de84bd8b",
          "attachmentType": "houseCard",
          "attachmentTypeName": "房产证",
          "affixUrl": "https://image.qfstatic.com/V20ceshishang_saas2_88a1796ee/image/2025/11/10/1762758205095/f7a1363b-c67c-9-0f69f48df115.jpg",
          "formatType": "image/jpeg",
          "createdTime": 1762758205296
        }
      ],
      "contractNo": "J1DJS202511100021"
    },
    {
      "propertyUuid": "a762ff11bfbb49029790a9dbc3349c5f",
      "entrustUuid": "73c0a85a50a84d3284275b9045b2bd51",
      "entrustType": "saleType",
      "entrustTypeName": "一般售委托",
      "entrustStatus": "passBegin",
      "entrustStatusName": "委托中",
      "entrustBeginTime": 1762444800000,
      "entrustEndTime": null,
      "realEndTime": null,
      "entrustCreatedTime": 1762497866085,
      "entrustNo": "YBS202511071436258614",
      "entrustEmpUuid": "ff334d09-397f-4c5e-9612-b890a87a37de",
      "entrustEmpName": "MISS王",
      "entrustEmpNo": "PPAV011173",
      "entrustDeptUuid": "99",
      "entrustDeptName": "系统管理组1",
      "propertyOwner": "王一一",
      "propertyOwnerPhone": "enc:SH96XTkivnGrd30R3Cx/5g==",
      "createdTime": 1762497866085,
      "esignContractUrl": "https://qfjiaoyi015.58wos.com.cn/tUYQpOnMtUYc/contract-c33467bb/5eb90c45b7285583990917770401.pdf?token=RTJ1Mi8xa0lFanVteVV2V1F5OFNxa0ZzQUhZPTpmPTVlYjg5NGQ5NTkwYzQ1YjBiNDliNzI4OGY1MTYzNGMzMTc4NTU4Mzk5MDkxNzc3MDQwMS5wZGYmZT0xNzY3MDg0MjMwJnI9NDk0NzI4NjY3Jm9wPWdldA%3D%3D",
      "miniAppContractUrl": null,
      "subSignType": "eSign",
      "subSignTypeName": "在线签约",
      "affixVOList": [
        {
          "entrustAffixUuid": "5386ae53ab79423c95a1e14bffe3a3a5",
          "entrustUuid": "73c0a85a50a84d3284275b9045b2bd51",
          "attachmentType": "idCard",
          "attachmentTypeName": "产权人身份证",
          "affixUrl": "https://image.qfstatic.com/V20ceshishangxianmao_saas2_88a1796ee/default/2025/11/7/2cceb0a31d0099422d7eb94.jpeg",
          "formatType": "image/jpeg",
          "createdTime": 1762497385890
        },
        {
          "entrustAffixUuid": "c4529150e8034f36b94ece978da26d98",
          "entrustUuid": "73c0a85a50a84d3284275b9045b2bd51",
          "attachmentType": "houseCard",
          "attachmentTypeName": "房产证",
          "affixUrl": "https://image.qfstatic.com/V20ceshishangxianmao_saas2_88a1796ee/default/2025/11/7/c68ffbd328f0202f5e2de0.mp4",
          "formatType": "video/mp4",
          "createdTime": 1762497385890
        },
        {
          "entrustAffixUuid": "794a44bb5300461a86946045657957df",
          "entrustUuid": "73c0a85a50a84d3284275b9045b2bd51",
          "attachmentType": "8fa53d2f-cae2-4262-b85b-0c6cc308be1a",
          "attachmentTypeName": "其他",
          "affixUrl": "https://image.qfstatic.com/V20ceshishangxianmao_saas2_88a1796ee/default/2025/11/7/d67c303847a7477e257aa1.jpeg",
          "formatType": "image/jpeg",
          "createdTime": 1762497385890
        }
      ],
      "contractNo": "YBS202511070009"
    }
  ]
}

巧房开放平台加解密算法



import org.apache.commons.codec.binary.Base64;
import org.apache.commons.lang3.StringUtils;

import javax.crypto.BadPaddingException;
import javax.crypto.Cipher;
import javax.crypto.IllegalBlockSizeException;
import javax.crypto.KeyGenerator;
import javax.crypto.NoSuchPaddingException;
import javax.crypto.spec.SecretKeySpec;
import java.nio.charset.StandardCharsets;
import java.security.InvalidKeyException;
import java.security.NoSuchAlgorithmException;
import java.security.SecureRandom;

public class AESCryptoUtil {

    public static final String ENC_PREFIX = "enc:";
    /**
     * 加密
     *
     * @param content  需要加密的内容
     * @param secretKey 加密秘钥
     */
    public static String encrypt(String content, String secretKey) {
        try {
            SecureRandom secureRandom = SecureRandom.getInstance("SHA1PRNG");
            secureRandom.setSeed(secretKey.getBytes(StandardCharsets.UTF_8));
            KeyGenerator kgen = KeyGenerator.getInstance("AES");
            kgen.init(128, secureRandom);
            byte[] enCodeFormat = kgen.generateKey().getEncoded();
            SecretKeySpec key = new SecretKeySpec(enCodeFormat, "AES");
            Cipher cipher = Cipher.getInstance("AES");// 创建密码器
            byte[] byteContent = content.getBytes(StandardCharsets.UTF_8);
            cipher.init(Cipher.ENCRYPT_MODE, key);// 初始化
            byte[] result = cipher.doFinal(byteContent);
            return Base64.encodeBase64String(result);
        } catch (NoSuchAlgorithmException | NoSuchPaddingException | InvalidKeyException |
                 IllegalBlockSizeException | BadPaddingException e) {
            throw new RuntimeException(e);
        }
    }

    /**
     * 解密
     * @param content  待解密内容
     * @param secretKey 解密密钥
     */
    public static String decrypt(byte[] content, String secretKey) {
        content = java.util.Base64.getDecoder().decode(content);
        try {
            SecureRandom secureRandom = SecureRandom.getInstance("SHA1PRNG");
            secureRandom.setSeed(secretKey.getBytes(StandardCharsets.UTF_8));

            KeyGenerator kgen = KeyGenerator.getInstance("AES");
            kgen.init(128, secureRandom);
            byte[] enCodeFormat = kgen.generateKey().getEncoded();
            SecretKeySpec key = new SecretKeySpec(enCodeFormat, "AES");
            Cipher cipher = Cipher.getInstance("AES");// 创建密码器
            cipher.init(Cipher.DECRYPT_MODE, key);// 初始化
            byte[] result = cipher.doFinal(content);
            return new String(result,StandardCharsets.UTF_8);
        } catch (NoSuchAlgorithmException | NoSuchPaddingException | InvalidKeyException | IllegalBlockSizeException |
                 BadPaddingException e) {
            throw new RuntimeException(e);
        }
    }

    /**
     * 解密
     * @param content  待解密内容
     * @param secretKey 解密密钥
     */
    public static String decrypt(String content, String secretKey) {
        if (StringUtils.isBlank(content)) {
            return content;
        }
        // 没有加密过不处理，兼容传明文数据
        if (!content.startsWith(ENC_PREFIX)) {
            return content;
        }
        String encryptStr = content.substring(ENC_PREFIX.length());
        return decrypt(encryptStr.getBytes(), secretKey);
    }

    public static void main(String[] args) {
        String secretKey ="e806d7148*******c6c8d7e224df5b";
        String content = "13812345678";
        //加密
        String jiami = ENC_PREFIX + encrypt(content, secretKey);

        //解密
        String jiemi = decrypt(jiami, secretKey);

        System.err.println(jiami);
        System.err.println(jiemi);

    }

}

results matching ""

    No results matching ""