智能小程序OPENCARD
开放类目

历史上的今天

用户在搜索“5月20日历史上的今天”，“历史上今天发生的重大事件”等需求时，搜索结果页会展现历史上的今天卡片，查看历史上今天发生的重大事件。点击每行可以跳转至每个事件的图文详情页（端内小程序+端外H5），击子链可跳转至更多完整历史今天事件列表等资源方落地页。

示意图

intent 上传接口

当前资源 intent 意图参数

key 类型 含义 示例/说明
data　 string 日期 可选，选后不可为空。资源方数据覆盖的日期，如：5月20日
type　 string 事件类型 可选，选后不可为空。资源方覆盖的事件类型，如：国内事件，国外事件

通过平台上传 txt 文件

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

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

1
2
3
4
{"data":"5月20日","type":"国内事件"}
{"data":"5月20日","type":""}
{"data":"","type":"国内事件"}
{"data":"","type":""}

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

intent组合 query类型 举例
data上传实体名、type上传实体名 指定日期的指定类型事件 如：“历史上5月20日发生的国内大事”
data上传实体名、type为空 指定日期发生的历史事件 如：“5月20日发生的历史事件”
data为空、type上传实体名 历史上的今天发生的指定类型事件 如：“国内历史上的今天发生大事”
data为空、type为空 历史上今天发生的事件 如：“历史上的今天”

通过开放 API 上传

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

发送给 webhook 的请求

公共字段

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

当前资源 srcid 资源编号

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

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

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

1
2
3
4
5
6
7
8
9
{
  "type": "sp_ala",
  "srcid": "48118",
  "surface": "mobile",
  "intent": {
    "data": "",
    "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 必选 事件发生日期，如：2002年05月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": "2002年05月20日",
			"type": 0,
			"url": "/page/of/target?id=1",
			"title": "东帝汶民主共和国正式成立"
		}, {
			"time": "1991年05月20日",
			"type": 0,
			"url": "/page/of/target?id=1",
			"title": "安理会通过伊拉克赔偿科威特损失的决议"
		}, {
			"time": "1990年05月20日",
			"type": 0,
			"url": "/page/of/target?id=1",
			"title": "李登辉在台北发表“总统”就职演说"
		}, {
			"time": "1987年05月20日",
			"type": 0,
			"url": "/page/of/target?id=1",
			"title": "魁北克省公民投票反对脱离加拿大"
		}, {
			"time": "1506年05月20日",
			"type": 0,
			"url": "/page/of/target?id=1",
			"title": "哥伦布逝世"
		}],
		"spreadtext": "展开更多",
		"slink": [{
			"text": "完整事件表",
			"url": "/page/of/target?id=1"
		}, {
			"text": "更多事件表",
			"url": "/page/of/target?id=1"
		}]
	}
}
漏洞查询精确需求 当年热点大事
反 馈帮 助 回 到顶 部