用户在搜索信用卡申请时,搜索会展现“信用卡申请“卡片,提供具体信用卡信息,满足用户的需求。
示意图
intent 上传接口
当前资源 intent 意图参数
key | 类型 | 含义 | 示例/说明 |
---|---|---|---|
bank | string | 银行名 | “招商银行” |
card | string | 银行卡名称 | “young卡” |
通过平台上传 txt 文件
资源方需要将自己小程序能够覆盖的所有 intent 参数组合通过 txt 文件上传到平台上,txt 文件的具体要求参见接入流程-上传 intent 数据。
当前资源分类 txt 上传文件内容示例如下:
1 | {"bank":"招行","card":"YOUNG卡"} |
通过开放 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 | 资源编号 | 5525 |
当前资源的 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 | 必选 | 卡片标题的跳转链接,跳转到卡片展现的信用卡列表页 |
item_list | array | 必选 | 信用卡列表,1-3个 |
item_list.image | string | 必选 | 信用卡图片,像素:364*243 |
item_list.url | string | 必选 | 单一信用卡的跳转链接,跳转到对应的信用卡介绍页 |
item_list.card_name | string | 必选 | 信用卡的名称 |
item_list.description | string | 必选 | 信用卡的摘要和说明,可以是功能介绍、优惠信息 |
item_list.button_text | string | 必选 | 申请按钮文案,1-2个汉字 |
item_list.button_url | string | 必选 | 按钮跳转的路径 ,点击按钮直接进入申请流程 |
举例:从 webhook 返回的 JSON (加密前)
1 | { |
审核常见问题
intent的编写及内容与intent的相关性
信用卡申请的intent可根据各银行信用卡种类泛化至穷尽,要求卡片展现内容与intent相关。intent及其对应的卡片展现内容正确示例如下:
bank | card | 卡片展现内容 |
---|---|---|
招行 | 信用卡 | 卡片展现招行多种信用卡,至多3种 |
招商银行 | 信用卡 | 卡片展现招行多种信用卡,至多3种 |
招行 | 白金卡 | 卡片展现招行多种白金卡,至多3种 |
招商银行 | 白金卡 | 卡片展现招行多种白金卡,至多3种 |
招行 | YOUNG卡 | 卡片展现招行YOUNG卡 |
招商银行 | YOUNG卡 | 卡片展现招行YOUNG卡 |
注意:可申请的信用卡类型应该完整,例如在{“bank”:”招行”,”card”:”YOUNG卡”}这一intent下,卡片应展示招行现有的两张YOUNG卡,而非其中一张。