智能小程序OPENCARD
开放类目

颜色查询器

用户在搜索颜色编码时(如:猩红色 RGB 代码),搜索结果页会展现颜色查询器卡片。卡片展示该颜色的颜色编码;点击左图右文结构体可跳转至相应颜色的图文详情页(端内小程序+端外 H5);点击子链可跳转至更多颜色信息等资源方落地页。

示意图

intent 上传接口

当前资源 intent 意图参数

key 类型 含义 示例/说明
colour   string 颜色名称 必选,资源方数据覆盖的颜色名、颜色编码或 RGB 编码,如:"猩红色","#dc143c" 等,提交的 intent 必须全部为小写字母

通过平台上传 txt 文件

资源方需要将自己落地页数据能够覆盖的所有 intent 参数通过 txt 文件上传到平台上,txt 文件的具体要求参见接入流程-上传 Intent 数据
当前资源分类 txt 上传文件内容示例如下:

1
2
{"colour":"猩红色"}
{"colour":"#dc143c"}

Webhook API

发送给 webhook 的请求

公共字段

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

当前资源 srcid 资源编号

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

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

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

1
2
3
4
5
6
7
8
{
"type": "sp_ala",
"srcid": "48093",
"surface": "mobile",
"intent": {
"colour": "猩红色"
}
}

从 webhook 返回的结果

外层通用数据字段

key 类型 含义 示例/说明
jump_url string 必选 点击卡片标题的跳转路径,应跳转至资源方落地页,落地页应包含该颜色详情介绍。如果收到的 surface 请求是 mobile,请返回小程序路径,如/page/of/target;如果收到的 surface 请求是 web_h5,请返回 H5 路径,如/page/of/target(以/开头,不含域名)
item array 必选 左图右文列表数据配置,固定为 1 组。
item_title string 必选 文字标题,颜色名,如:“猩红(Crimson)”
item_image string 必选 图片链接,相应颜色的图片。以“https”开头的图片链接图片横竖比 1:1
item_text1 string 必选 对应颜色的数据值,如:“颜色编码: #DC143C”
item_text2 string 必选 对应颜色的数据值,如:“RGB 编码: 220.20.60”
item_text3 string 必选 对应颜色的数据值,如:“CMYK 编码: 16.98.72.0”
item_url string 必选 点击左图右文结构的跳转链接地址,跳转至该颜色详细介绍。url 字段需返回 H5 或智能小程序页面路径。如:“/page/of/target“
slink array 必选 子链列表,最少 2 个,最多 3 个
slink_text string 必选 子链文案,最短 1 个字符,最长 6 个字符
slink_url string 必选 子链跳转链接,如:“/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
{
"status": 0,
"msg": "",
"data": {
"jump_url": "/page/of/target?id=1",
"item": [
{
"item_title": "猩红(Crimson)",
"item_image": "https://ss2.baidu.com/6ONYsjip0QIZ8tyhnq/it/u=2111157044,737589643&fm=179&app=35&f=PNG?w=39&h=24",
"item_text1": "颜色编码:#DC143C",
"item_text2": "RGB编码:220.20.60",
"item_text3": "CMYK编码:16.98.72.0",
"item_url": "/page/of/target?id=1"
}
],
"slink": [
{ "slink_text": "更多颜色信息", "slink_url": "/page/of/target?id=1" },
{ "slink_text": "更多颜色信息", "slink_url": "/page/of/target?id=1" }
]
}
}
反 馈帮 助 回 到顶 部