智能小程序OPENCARD
开放类目

小区楼盘查询

用户在搜索“运河铭著““西山壹号院“等楼盘、小区精准需求时，搜索结果页会展现“小区楼盘查询”卡片，提供房产的相关信息，如走楼盘位置、楼盘特点、价格、面积等信息，引导用户点击进入楼盘落地页进行房产信息的获取。

示意图

intent 上传接口

当前资源 intent 意图参数

key 类型 含义 示例/说明
house string 楼盘/小区名 必选，如”西山壹号院”

通过平台上传 txt 文件

资源方需要将自己落地页数据能够覆盖的所有 intent 参数组合通过 txt 文件上传到平台上，txt 文件的具体要求参见接入流程-上传 Intent 数据。

当前资源分类 txt 上传文件内容示例如下：

1
2
{"house":"西山壹号院"}
{"house":"运河铭著"}

通过开放 API 上传

详细接入方式参见 API 上传方式

Webhook API

发送给 webhook 的请求

公共字段

key 类型 含义 示例/说明
type string 请求类型 在小程序阿拉丁下永远为 “sp_ala”
surface string 搜索场景 mobile: 支持小程序的移动搜索，web_h5: 支持 H5 的移动搜索
srcid string 资源编号 每个资源分类不同
intent object 搜索意图参数 JSON 对象，每个资源分类不同
location object 用户定位信息 JSON 对象
location.province string 用户所在省份 “北京”/“浙江”，不含行政区划单位，例如”市、省、自治区”，可能为空
location.city string 用户所在城市 “北京”/“杭州”，不含行政区划单位，例如”市”，可能为空
query_location object 用户表达的位置信息，应优先选用用户表达的位置信息进行检索 JSON 对象
query_location.query_province string 用户 Query 中指定的省份 “北京”/“河南”，不含行政区划单位，例如”市、省、自治区”，可能为空
query_location.query_city string 用户 Query 中指定的地级市 “北京”/“开封”，不含行政区划单位，例如”市”，可能为空
query_location.query_county string 用户 Query 中指定的县、区 “海淀”/“兰考”，不含行政区划单位，例如”县、区”，可能为空

当前资源 srcid 资源编号

key 类型 含义 设定
srcid string 资源编号 48023

当前资源的 intent 参数参考上节 “intent 上传接口“。

举例：发送给 webhook 的 JSON (解密后)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
  "type": "sp_ala",
  "srcid": "48023",
  "surface": "mobile",
  "intent": {
    "house": "西山壹号院"
  },
  "location": {
    "province": "浙江",
    "city": "杭州"
  },
  "query_location": {
    "query_province": "北京",
    "query_city": "北京",
    "query_county": "海淀"
  }
}

注:应优先使用 query_location 进行相应地域的筛选,“query_location”为空时再使用“location” 进行筛选。

从 webhook 返回的结果

外层通用数据字段

key 类型 含义 示例/说明
status integer 结果状态码，0 代表正确，1 代表无结果，
2 代表请求参数错误，3 代表内部服务错误		 0
msg string 出错消息，当非 0 时提供 “”
data object 要返回的资源数据内容 JSON 对象，每个资源分类不同

当前资源分类的 data object 字段内容

key 类型 要求 说明
jump_url string 必选 点击卡片标题跳转的链接地址，落地页需满足用户需求。若卡片仅展现 1 个楼盘，应跳转到该楼盘详细信息页面；若卡片展现 2-3 个楼盘，应跳转到列表页。
item_list array 必选 左图右文列表数据，最少 1 个，最多 3 个。
item_list.title string 必选 标题，格式为：楼盘名-楼盘状态，不得有其他信息，不得超过 16 个字；新楼盘：标题上带上楼盘状态，如“运河铭著-开盘”、“运河铭著-在售”等；如搜索 query 楼盘为非新房，标题中明确为“二手房租房”，如“融泽嘉园-二手房租房”。
item_list.image string 必选 图片比例为 1:1，保证结果页与落地页的图片一致。
item_list.district string 必选 小区楼盘所处的商圈或位置，不得超过 16 个字，不得有其他类型得内容，如：“通州-北关”，如：“马连洼—五至六环”。
item_list.describe string 必选 楼盘描述，提交该楼盘或小区的其他必要的基本信息，不得超过 16 个字，表达的内容必须完整，不能有截断，表达的内容不得与本卡其他字段表达的内容重复，如：不得在此处表达价格、在售状态等其他字段已有体现的内容。举例：“集中供暖/13 年建成/绿化率 30%”
item_list.tag_list_text array 必选 体现楼盘特点或核心卖点的 tag，最多 3 个标签，每个标签内最多 5 个字，标签表达的内容不得与本卡其他字段表达的内容重复。
item_list.url string 必选 对应楼盘的跳转链接，点击跳转到相应楼盘落地页详情详情。
item_list.price integer 必选 价格，默认单位是分，如果价格为 10000 元/平，则输入 1000000。价格为必选字段，如果楼盘价格未定，可提交一个预估的价格，如预估价格也没有，则不要返回该字段，此楼盘需求下也不会出卡，不得返回 0 等无意义的价格，价格必须与落地页保持一致。
item_list.price_info string 可选 价格补充文案，最多 6 个字，如：”已售 19 套”。

举例：从 webhook 返回的 JSON (加密前)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
  "status": 0,
  "msg": "",
  "data": {
    "jump_url": "/page/of/target?id=1",
    "item_list": [
      {
        "title": "运河铭著-在售（已开盘）",
        "image": "https://ss2.baidu.com/6ONYsjip0QIZ8tyhnq/it/u=565209980,4226652513&fm=179&app=35&f=JPEG?w=500&h=500&s=59843C7289C7684B16D810CE000070B2",
        "district": "通州-北关",
        "describe": "集中供暖/13年建成/30%绿化",
        "tag_list_text": ["地铁沿线", "地铁沿线", "地铁沿线"],
        "url": "/page/of/target?id=1",
        "price": "100000",
        "price_info": "月售138套"
      }
    ]
  }
}
视频知识专栏 购房资格查询
反 馈帮 助 回 到顶 部