智能小程序OPENCARD
开放类目

花卉养护知识

用户在搜索具体花卉植物种植养护信息等需求时(如:蟹爪兰怎么样种),结果页会展现花卉种植知识卡片。卡片展示该花卉植物的养护技巧;点击特定品种的左图右文结构体可跳转至相应品种的图文详情页(端内小程序+端外 H5);点击子链可跳转至更多养护技巧服务的资源方落地页。

示意图

intent 上传接口

当前资源 intent 意图参数

key 类型 含义 示例/说明
flowers_type   string 花卉名称 必选,资源方数据覆盖的植物,如:"蟹爪兰","吊兰" 等

通过平台上传 txt 文件

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

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

1
2
{"flowers_type":"蟹爪兰"}
{"flowers_type":"吊兰"}

Webhook API

发送给 webhook 的请求

公共字段

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

当前资源 srcid 资源编号

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

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

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

1
2
3
4
5
6
7
8
{
"type": "sp_ala",
"srcid": "48076",
"surface": "mobile",
"intent": {
"flowers_type": "蟹爪兰"
}
}

从 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”
data_title string 必选 标题文案,花卉名称。如:“蟹爪兰”“吊兰”等花卉名
image string 必选 对应花卉图片链接,以“https”开头
flower_data string 必选 花卉基本信息文本,植物科与植物属。如:如:仙人掌科 蟹爪兰属
flower_text string 必选 花卉简介文案,以“简介:”开头,对该花卉特点的阐述
flower_label string 必选 花卉标签组,对该花卉特点进行阐述,例如:喜阴,喜干
data_url string 必选 点击左图右文结构的跳转链接地址,跳转至花卉详情页。url 字段需返回 H5 或智能小程序。如:/page/of/target
table_rows array 必选 表格数据配置。二列,四行。
table_rows.data string 必选 表格第一列文案,花卉养护技巧的属性分类。如:水分 光照 温度 施肥
table_rows.description string 必选 表格第二列文案,具体花卉养护的属性描述。如:保持土壤湿润,宁干勿湿
slink_list array 必选 子链列表,最少 2 个,最多 3 个
slink_list.text string 必选 子链文案,第一个子链固定上传“更多养护技巧”,其余子链为资源方相关的其他服务名称,如“其他花卉养护”,最短 1 个字符,最长 6 个字符。如:如:“更多养护技巧” “其他花卉养护”
slink_list.url string 必选 子链跳转链接,资源方“更多养护技巧”或其他服务的落地页路径,该字段需返回 H5 或智能小程序页面路径。如:“/page/of/target”

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
{
"status": 0,
"msg": "",
"data": {
"jump_url": "/page/of/target?id=1",
"data_title": "蟹爪兰",
"image": "https://ss1.baidu.com/6ONXsjip0QIZ8tyhnq/it/u=1338842158,3293522213&fm=179&app=35&f=JPEG?w=310&h=310&s=D03333D1984152DE0DB5343703001022",
"flower_data": "仙人掌科 蟹爪兰属",
"flower_text": "简介:灌木状,茎悬垂,多分枝无刺,老茎木质化,幼茎扁平;鲜绿色或稍带紫色,顶端截形,花单生于枝顶,两侧对称;花冠数轮,雄蕊多数,浆果梨形。 室内栽培的蟹爪兰可通过控制光照来调节花期。",
"flower_label": ["喜阴", "喜阴"],
"data_url": "/page/of/target?id=1",
"table_rows": [
{ "data": "水分", "description": "保持土壤湿润,宁干勿湿" },
{ "data": "水分", "description": "保持土壤湿润,宁干勿湿" },
{ "data": "水分", "description": "保持土壤湿润,宁干勿湿" },
{ "data": "水分", "description": "保持土壤湿润,宁干勿湿" }
],
"slink_list": [
{ "text": "更多养护知识", "url": "https://m.baidu.com" },
{ "text": "更多养护知识", "url": "https://m.baidu.com" }
]
}
}
反 馈帮 助 回 到顶 部