Skip to content

房源信息获取接口

简要说明：

  • 众趣请求对接方，获取房源信息数据，以补全文案生成内容。
  • 以下是合作方需要在文档中进行完善的内容，如有需协商或者协调的内容及事项，请及时联系众趣科技相关技术人员。

请求URL：

  • 格式参考：https://{$HostName}/{$api}/
  • $HostName: 请求访问的地址， 示例: api.3dnest.com
  • $api: 中间的api地址, 示例: a/b/c/d

请求方式：

  • GET

参数传递方式：

  • application/json

签名生成方式：

  • MD5（hid+app_id+timestamp）
  • app_id 密钥（众趣测提供的开放平台对接的那个app_id）需合作方提供给众趣

请求参数：

参数名 必选 类型 说明 示例
hid 是 string 房源ID "21812721921712"
timestamp 是 string 精·确到秒的时间戳，用于对比密钥 "1546493950"
key 是 string 签名 "651149665ae4f21700d25da1de74dff4"
app_id 是 string 众趣测提供的开放平台对接的那个app_id "ApUcvBbJ4L2g"

返回参数说明:

参数名 类型 说明
code int 消息码
msg string 返回详细信息
data String(json) 房源数据

返回数据结构：

参数名 必有项 类型 说明 示例
coordinate 是 Array 坐标 ["纬度","经度"]
lpName 是 String 楼盘名称 "XXX"
hid 是 string 房源ID "21812721921712"
city 是 string 城市 "XXX"
region 是 string 区域 "XXX"
residential_quarters 否 Object 小区讲解 "XXX"
├─ copywriting 否 string 小区内部文案 "XXX"
├─ aerial_photography 否 Array 航拍 ["xxx"]
├─ residential_area_photos 否 Array 小区照片 ["https://xxx"]
periphery 否 Object 外部配套讲解
├─ replace_query 否 Array 周边设施替换项（详情见下方示例数据） []
├─ name 否 string 配套设施名称 "小学" 或 中学
├─ coordinate 否 Array 周边配套坐标（详情见下方示例数据） ["纬度","经度"]
├─ not_query 否 Array 不做查询的周边设施 ["飞机场", "菜市场"]
house 否 Object 房屋讲解
├─ overall_overview 否 string 房屋户型总体概述 "XXX"
├─ house_info_copywriting 否 string 房子信息文案（用于描述房屋产权资质等信息） "XXX"

消息码及对应的参数示例：

code msg 响应类型
1 房源信息查询成功！ 成功。
2 校验失败，签名错误！ 失败。
3 参数传输方式有误！ 失败。
4 参数不全！ 失败。
5 房源信息不存在！ 失败。
6 数据库查询失败！ 失败。
除成功状态外，其它返回信息都可调整

响应方式：

  • · json

示例：

{
    "code": 1 ,
"msg":"房源信息查询成功！",
"data":{
    "coordinate": ["22.601323","114.126783"],
    "city" : "龙岗",
"region" : "百鸽笼",
    "residential_quarters": {
        "aerial_photography": ["xxx"],
        "residential_area_photos": ["xxx"],
        "copywriting": "小区是2006年建的小区；小区一共有3栋；有电梯，上下楼比较方便；小区全封闭式，小区有保安站岗、24小时巡逻、定期消防演习、监控覆盖，小区的安全有保障"
    },
    "periphery": {
        "replace_query": [
            {"name": "百合公园小学", "type":"小学", "coordinate": [22.60129,114.133682]},
            {"name": "翠园东晓中学", "type":"中学", "coordinate": [22.589436,114.141767]}
        ],
        "not_query": ["飞机场"]
    },
    "house": {
        "overall_overview": "接下来我们看一下房子的具体情况；这个房子是【精装】，可直接拎包入住；户型是4室2厅2卫1厨3阳；户型方正，实用率高；复式结构。",
        "house_info_copywriting": "接下来为您介绍这套房子的具体情况；这套房子从业主购买到现在已经5年以上了；是业主唯一持有的房子；房子随时可看，【看房方便】；此外业主诚心出售，是【必卖好房】。"
    }
}

备注：

  • · 此文档仅作为参考，合作方可根据具体需求与众趣科技相关技术人员进行沟通协商。