用户在搜索颜色编码时(如:猩红色 RGB 代码),搜索结果页会展现颜色查询器卡片。卡片展示该颜色的颜色编码;点击左图右文结构体可跳转至相应颜色的图文详情页(端内小程序+端外 H5);点击子链可跳转至更多颜色信息等资源方落地页。
示意图
intent 上传接口
当前资源 intent 意图参数
key | 类型 | 含义 | 示例/说明 |
---|---|---|---|
colour | string | 颜色名称 | 必选,资源方数据覆盖的颜色名、颜色编码或 RGB 编码,如:"猩红色","#dc143c" 等,提交的 intent 必须全部为小写字母 |
通过平台上传 txt 文件
资源方需要将自己落地页数据能够覆盖的所有 intent 参数通过 txt 文件上传到平台上,txt 文件的具体要求参见接入流程-上传 Intent 数据。
当前资源分类 txt 上传文件内容示例如下:
1 | {"colour":"猩红色"} |
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 | { |
从 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 | { |