智能小程序OPENCARD
开放类目

当年热点大事

用户在搜索“2012年发生了哪些大事”,“鼠年发生了什么大事”等需求时,搜索结果页会展现当年热点大事卡片,查看历史上当年发生的重大事件。点击每行可以跳转至每个事件的图文详情页(端内小程序+端外H5),击子链可跳转至更多完整当年热点大事事件列表等资源方落地页。

示意图

intent 上传接口

当前资源 intent 意图参数

key 类型 含义 示例/说明
year  string 年份 必选,选后不可为空。资源方数据覆盖的时间,如:2008年,鼠年
type  string 事件类型 可选,选后不可为空。资源方覆盖的事件类型,如:国内事件,国外事件

通过平台上传 txt 文件

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

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

1
2
{"year":"2008年","type":"国内事件"}
{"year":"2008年","type":""}

注意:上述两种intent组合分别在以下两类query下召回此卡片:

intent组合 query类型 举例
year上传实体名、type上传实体名 指定年份发生的指定类型事件 如:“2012年国内发生了哪些大事”
year上传实体名、type为空 指定年份发生的事件 如:“2012年发生了哪些大事”

通过开放 API 上传

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

发送给 webhook 的请求

公共字段

key 类型 含义 示例/说明
type string 请求类型 在小程序阿拉丁下永远为 “sp_ala”
surface string 搜索场景 mobile: 支持小程序的移动搜索,web_h5: 支持 H5 的移动搜索
srcid string 资源编号 每个资源分类不同
intent object 搜索意图参数 JSON 对象,每个资源分类不同

当前资源 srcid 资源编号

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

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

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

1
2
3
4
5
6
7
8
{
"type": "sp_ala",
"srcid": "48120",
"surface": "mobile",
"intent": {
"year":"2012年","type":"国内事件"
}
}

从 webhook 返回的结果

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

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

key 类型 要求 说明
adjective string 必选 类目名称,固定为:当年热点大事
jump_url string 必选 点击卡片标题的跳转路径,应跳转至资源方落地页,该落地页应包含卡片展现的事件信息。如果收到的surface请求是mobile,请返回小程序路径,如/page/of/target;如果收到的surface请求是web_h5,请返回H5路径,如/page/of/target(以/开头,不含域名)
tag array 可选 等分Tag 列表,最少3个,最多5个
tag.text string 可选 tag文案,第一个tag需要与返回的intent中所包含的句子类型相吻合,如:综合热点事件
tag.url string 可选 tag链接地址。如:“/page/of/target”
list array 必选 时间脉络列表,最少5个,最多25个。事件应该应按发生事件排序,时间越近,排序越靠前。
list.time string 必选 事件发生日期,如:2012年01月20日
list.type number 必选 时间类型,0-字符串类型,1-时间戳类型,默认选择0
list.url string 必选 事件跳转链接,落地页应有对应事件的详细图文说明
list.title string 必选 事件标题,对事件的简要说明,如:“神九”“天宫”手控交会对接成功
spreadtext string 必选 展开按钮文字,固定为:“展开更多”
slink array 可选 子链列表,最少2个,最多3个
slink.text string 可选 子链文案,最短1个字符,最长6个字符,如:“完整事件列表”
slink.url string 可选 子链跳转链接,如:“/page/of/target”
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
{
"status": 0,
"msg": "",
"data": {
"adjective": "当年热点大事",
"jump_url": "/page/of/target?id=1",
"tag": [{
"text": "综合热点事件",
"url": "/page/of/target?id=1"
}, {
"text": "国内热点事件",
"url": "/page/of/target?id=1"
}, {
"text": "国外热点事情",
"url": "/page/of/target?id=1"
}],
"list": [{
"time": "2012年1月1日",
"type": 0,
"url": "/page/of/target?id=1",
"title": "“神九”“天宫”手控交会对接成功 "
}, {
"time": "2012年2月2日",
"type": 0,
"url": "/page/of/target?id=1",
"title": "伦敦奥林匹克运动会圣火在希腊古奥林匹亚运动场正式点燃"
}, {
"time": "2012年3月3日",
"type": 0,
"url": "/page/of/target?id=1",
"title": "美国总统奥巴马在大选中获胜"
}, {
"time": "2012年4月4日",
"type": 0,
"url": "/page/of/target?id=1",
"title": "第四轮中美战略与经济对话在北京举行"
}, {
"time": "2012年5月5日",
"type": 0,
"url": "/page/of/target?id=1",
"title": "第30届夏季奥林匹克运动会在伦敦举行"
}],
"spreadtext": "展开更多",
"slink": [{
"text": "完整当年事件",
"url": "/page/of/target?id=1"
}, {
"text": "更多年份事件",
"url": "/page/of/target?id=1"
}]
}
}
反 馈帮 助 回 到顶 部