用户在搜索“名家书法”、“王羲之书法作品”等需求时，结果页会展现名家书法查询卡片。卡片展示用户检索的书法家代表作品大图与介绍文案，以及该书法家其余作品的 tag，点击 tag 或卡片其它位置则跳转至资源方提供的相应书法作品详情页。
示意图
intent 上传接口
当前资源 intent 意图参数
| key | 类型 | 含义 | 示例/说明 |
|---|---|---|---|
| calligrapher | string | 书法家 | 必选，书法家的名字，如：＂王羲之＂ |
| calligraphy_name | string | 书法作品 | 必选，书法作品或碑帖的名称，如：＂兰亭序＂ |
通过平台上传 txt 文件
资源方需要将自己落地页数据能够覆盖的所有 intent 参数组合通过 txt 文件上传到平台上，txt 文件的具体要求参见接入流程-上传 Intent 数据。
当前资源分类 txt 上传文件内容示例如下：
1 | {"calligrapher":"王羲之","calligraphy_name":"兰亭序"} |
注意：上述四种 intent 组合分别在以下四类 query 下召回此卡片：
| intent 组合 | query 类型 | 举例 |
|---|---|---|
| calligrapher 上传实体名、calligraphy_name 上传实体名 | 特定书法家的具体作品查询需求 | 如“王羲之兰亭序” |
| calligrapher 上传实体名、calligraphy_name 为空 | 特定书法家的代表作泛需求 | 如“王羲之书法” |
| calligrapher 为空、calligraphy_name 上传实体名 | 特定书法作品的查询需求 | 如“兰亭序书法” |
| calligrapher 为空、calligraphy_name 为空 | 书法作品查询泛需求 | 如“名家书法作品” |
通过开放 API 上传
详细接入方式参见 API 上传方式
Webhook API
发送给 webhook 的请求
公共字段
| key | 类型 | 含义 | 示例/说明 |
|---|---|---|---|
| type | string | 请求类型 | 在小程序阿拉丁下永远为 “sp_ala” |
| surface | string | 搜索场景 | mobile: 支持小程序的移动搜索，web_h5: 支持 H5 的移动搜索 |
| srcid | string | 资源编号 | 每个资源分类不同 |
| intent | object | 搜索意图参数 | JSON 对象，每个资源分类不同 |
当前资源 srcid 资源编号
| key | 类型 | 含义 | 设定 |
|---|---|---|---|
| srcid | string | 资源编号 | 48031 |
当前资源的 intent 参数参考上节 “intent 上传接口“。
举例：发送给 webhook 的 JSON (解密后)
1 | { |
从 webhook 返回的结果
外层通用数据字段
| key | 类型 | 含义 | 示例/说明 |
|---|---|---|---|
| status | integer | 结果状态码，0 代表正确，1 代表无结果， 2 代表请求参数错误，3 代表内部服务错误 |
0 |
| msg | string | 出错消息，当非 0 时提供 | “” |
| data | object | 要返回的资源数据内容 | JSON 对象，每个资源分类不同 |
当前资源分类的 data object 字段内容
| key | 类型 | 要求 | 说明 |
|---|---|---|---|
| jump_url | string | 必选 | 点击卡片除 tag 外其他位置的跳转链接，跳转至能满足相应名家书法作品查询需求的落地页。该字段需返回 H5 或智能小程序页面路径，例如“/page/of/target”。 |
| content_list | array | 必选 | 内容区数据配置，最少 3 个，最多 5 个 |
| content_list.tag_text | string | 可选，选后不可为空 | Tag 文案数据，在精准需求下，为书法家的代表作品名称，如“兰亭序”“尔今帖”“快雪时晴帖”“建安帖”等；在泛需求（即两个 intent 均为空）的 query 下，为热门书法家的名字“王羲之”“颜真卿”等。 |
| content_list.tag_url | string | 可选，选后不可为空 | Tag 跳转链接地址，一般为 tag 文案对应书法作品的详情页。该字段需返回 H5 或智能小程序页面路径，例如“/page/of/target”。 |
| img_src | string | 必选 | 大图链接地址，名家书法作品的图片地址，以 https 开头，例如：https://ss1.baidu.com/6ONXsjip0QIZ8tyhnq/it/u=4263960754,972552223&fm=179&app=35&f=JPEG?w=600&h=813&s=119AEF7F47F7E9CE184800EA0300A032 |
| img_text | string | 必选 | 大图底部文案，对该书法作品的介绍或赏析，不超过 300 个字符 |
举例：从 webhook 返回的 JSON (加密前)
1 | { |