智能小程序OPENCARD
开放类目

生肖年龄

用户在搜索某个生肖的年龄时，在结果页展示列表该生肖的出生年份、及对应的岁数。覆盖 query 包括：属兔今年多大、属兔的今年岁数。

示意图

intent 上传接口

当前资源 intent 意图参数

key 类型 含义 示例/说明
zodiac string 生肖 必选，如“兔”、“牛”

通过平台上传 txt 文件

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

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

1
2
{"zodiac":"兔"}
{"zodiac":"牛"}

通过开放 API 上传

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

Webhook API

发送给 webhook 的请求

公共字段

key 类型 含义 示例/说明
type string 请求类型 在小程序阿拉丁下永远为 “sp_ala”
surface string 搜索场景 mobile: 支持小程序的移动搜索，web_h5: 支持 H5 的移动搜索
srcid string 资源编号 每个资源分类不同
intent object 搜索意图参数 JSON 对象，每个资源分类不同
query_info.birthday string 用户 query 中的出生年份信息 用户的出生年份，如：“1984”
query_info.year string 用户 query 中的当前年份信息 如“2020”、“2021”

当前资源 srcid 资源编号

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

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

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

1
2
3
4
5
6
7
8
9
10
11
{
  "type": "sp_ala",
  "srcid": "48089",
  "surface": "mobile",
  "intent": {
    "zodiac": "兔"
  },
  "query_info": {
    "birthday": "1984"
  }
}

从 webhook 返回的结果

外层通用数据字段

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

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

key 类型 要求 说明
jump_url string 必选 点击卡片标题的跳转路径，应跳转至资源方落地页，该落地页应包含卡片展示的内容全集，如果收到的 surface 请求是 mobile，请返回小程序路径，如/page/of/target；如果收到的 surface 请求是 web_h5，请返回 H5 路径，如/page/of/target（以/开头，不含域名）
table_head1 string 必选 表头文案 1，如：“生日年份”
table_head2 string 必选 表头文案 2，如：“属性”
table_head3 string 必选 表头文案 3，如：“今年年龄”
item_row array 必选 表格数据配置，最少 2 个，最多 25 个
item_col1 string 必选 第 1 列，对应生日年份，如“2011 年”
item_col2 string 必选 第 2 列，对应属相，如“属兔”
item_col3 string 必选 第 3 列，对应年龄，如“9 岁”

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{
  "status": 0,
  "msg": "",
  "data": {
    "jump_url": "/page/of/target?id=1",
    "table_head1": "生日年份",
    "table_head2": "属相",
    "table_head3": "今年年龄",
    "item_row": [
      { "item_col1": "2011年", "item_col2": "属兔", "item_col3": "9岁" },
      { "item_col1": "2011年", "item_col2": "属兔", "item_col3": "9岁" },
      { "item_col1": "2011年", "item_col2": "属兔", "item_col3": "9岁" },
      { "item_col1": "2011年", "item_col2": "属兔", "item_col3": "9岁" },
      { "item_col1": "2011年", "item_col2": "属兔", "item_col3": "9岁" },
      { "item_col1": "2011年", "item_col2": "属兔", "item_col3": "9岁" },
      { "item_col1": "2011年", "item_col2": "属兔", "item_col3": "9岁" },
      { "item_col1": "2011年", "item_col2": "属兔", "item_col3": "9岁" }
    ]
  }
}
生肖配对 姓名缘分测试
反 馈帮 助 回 到顶 部