智能小程序OPENCARD
开放类目

生肖运势

用户在搜索某个生肖或某个生肖运势时，在结果页展示该生肖的运势、性格及宜配属相。覆盖 query 包括：属龙、属龙人 2020 年运势，1984 年出生的龙 2020 年运势怎么样。

示意图

intent 上传接口

当前资源 intent 意图参数

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

通过平台上传 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 资源编号 48079

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

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

1
2
3
4
5
6
7
8
9
10
11
{
  "type": "sp_ala",
  "srcid": "48079",
  "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 必选 点击卡片的跳转路径。该字段需返回 H5 或智能小程序页面路径，如果收到的 surface 请求是 mobile，请返回小程序路径，如果收到的 surface 请求是 web_h5，请返回 H5 路径，例如：“/page/of/target”
img string 必选 属相图像，https 格式
subTitle string 必选 左图右文标题，最短 1 个字符，最长 100 个字符，标题内容应与 intent“year”相对应，如 year=2020，标题为“属龙的人 2020 年运势”
feature string 必选 生肖性格，文本段落，2 行截断，最短 1 个字符，最长 30 个字符，例如：聪明沉稳，性情淡薄
yearLabels array 必选 年份标签，3 个，字符串数组
tabList array 必选 运势 tab 列表，最多 5 个
tabList.text string 必选 运势 tab 的文案，最短 1 个字符，最长 100 个字符，例如：总体
tabList.content string 必选 tab 下的内容，5 行截断，最短 1 个字符，最长 200 个字符，运势内容应与 query_info.birthday 字段相对应，如用户表明了问 1984 年出生的龙运势怎么样，那么运势内容中应在开头显眼处体现 1984 年这个关键信息
tabList.tabUrl string 必选 每个 tab 下内容的点击跳转链接，该字段需返回 H5 或智能小程序页面路径，例如“/page/of/target”
matchZodiac string 必选 匹配属相，最短 1 个字符，最长 100 个字符，例如：宜配属相：狗、虎
starsInfo string 必选 对评分的说明，短文本，最短 1 个字符，最长 100 个字符，由运势分数+运势说明构成，例如：5 分 运势良好
starCount number 必选 评分星数，例如：3

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
  "status": 0,
  "msg": "string",
  "data": {
    "jump_url": "/page/of/target",
    "img": "https://ss0.baidu.com/6ONWsjip0QIZ8tyhnq/it/u=2379086268,2130850456&fm=58",
    "subTitle": "属龙的人 2020年运势",
    "feature": "聪明沉稳，性情淡薄",
    "yearLabels": ["string"],
    "tabList": [
      { "text": "总体", "content": "string", "tabUrl": "/page/of/target" }
    ],
    "matchZodiac": "宜配属相：狗、虎",
    "starsInfo": "5分 运势良好",
    "starCount": 3
  }
}
起英文名服务 生肖配对
反 馈帮 助 回 到顶 部