用户在搜索名字缘分测试等需求时,在结果页展示姓名缘分测试卡片。卡片为双输入框模板工具卡片,点击按钮即可查看名字缘分测试结果,点击标题可以跳转至缘分测试图文详情页(端内小程序+端外H5)。
示意图
intent 上传接口
当前资源 intent 意图参数
key | 类型 | 含义 | 示例/说明 |
---|---|---|---|
predestination_test | string | 服务类型 | 可选,提供的服务类型-姓名缘分测试 |
通过平台上传 txt 文件
资源方仅需要通过txt 文件上传一个空的intent到平台,txt 文件的具体要求参见接入流程-上传 Intent 数据
当前资源分类 txt 上传文件内容示例如下:
1 | {"predestination_test":""} |
通过开放 API 上传
详细接入方式参见API上传方式
发送给 webhook 的请求
公共字段
key | 类型 | 含义 | 示例/说明 |
---|---|---|---|
type | string | 请求类型 | 在小程序阿拉丁下永远为 “sp_ala” |
surface | string | 搜索场景 | mobile: 支持小程序的移动搜索,web_h5: 支持 H5 的移动搜索 |
srcid | string | 资源编号 | 每个资源分类不同 |
intent | object | 搜索意图参数 | JSON 对象,每个资源分类不同 |
当前资源 srcid 资源编号
key | 类型 | 含义 | 设定 |
---|---|---|---|
srcid | string | 资源编号 | 48124 |
当前资源的 intent 参数参考上节 “intent 上传接口“。
举例:发送给 webhook 的 JSON (解密后)
1 | { |
从 webhook 返回的结果
外层通用数据字段
key | 类型 | 含义 | 示例/说明 |
---|---|---|---|
status | integer | 结果状态码,0 代表正确,1 代表无结果, 2 代表请求参数错误,3 代表内部服务错误 |
0 |
msg | string | 出错消息,当非 0 时提供 | “” |
data | object | 要返回的资源数据内容 | JSON 对象,每个资源分类不同 |
当前资源分类的data
object字段内容
key | 类型 | 要求 | 说明 |
---|---|---|---|
tool_name | string | 必选 | 类目名称,固定为:“姓名缘分测试” |
jump_url | string | 必选 | 点击卡片标题的跳转路径,应跳转至资源方落地页,该落地页应含有姓名缘分测试功能。如果收到的surface请求是mobile,请返回小程序路径,如/page/of/target;如果收到的surface请求是web_h5,请返回H5路径,如/page/of/target(以/开头,不含域名) |
submit_url | string | 必选 | 点击按钮的跳转路径,跳转至计算结果页。以“/page/of/target?param1={{val1}}¶m2={{val2}}”形式上传。其中,param1对应用户输入的第一个文本框key,param2对应用户输入的第二个文本框key,可根据需要改写为具体的名称。{{val1}}、{{val2}}是固定字符,会替换为用户输入的具体数值,请不要修改 |
item1 | string | 可选,选后不可为空 | 表单名称,最多4个字,如:“男方姓名” |
input_text1 | string | 必选 | 输入框提示文案,如:“请输入男方姓名” |
item2 | string | 可选,选后不可为空 | 表单名称,最多4个字,如:“女方姓名” |
input_text2 | string | 必选 | 输入框提示文案,如:“请输入女方姓名” |
button_text | string | 必选 | 按钮文案,最短2个字符,最长6个字符,如:“点击查看缘分” |
slink | array | 可选 | 子链列表,最少2个,最多5个 |
slink.slink_text | string | 可选,选后不可为空 | 子链单项的文案,最短1个字符,最长10个字符,例如:详细缘分分析 |
slink.slink_url | string | 可选 | 子链跳转链接,如:“/page/of/target” |
statement | string | 可选,选后不可为空 | 底部声明文案,对卡片进行注释说明,不超过24个字符。如:“输入男女双方名字,点击查看缘分测试情况” |
1 | { |