智能小程序OPENCARD
开放类目

公司店铺起名

用户在搜索“公司起名”、“店铺起名”等需求时,结果页会展现公司店铺起名卡片。卡片展示该服务卡片;用户可在结果页输入公司行业,下拉菜单选择起名字数,点击按钮跳转至资源方落地页查看合适的公司店铺名字。

示意图

intent 上传接口

当前资源 intent 意图参数

key 类型 含义 示例/说明
name_id string 工具或服务类型 必选,公司行业分类

通过平台上传 txt 文件

资源方仅需要通过txt 文件上传一个空的intent到平台,txt 文件的具体要求参见接入流程-上传 Intent 数据

当前资源分类 txt 上传文件内容示例如下:

1
{"name_id":""}

通过开放 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 资源编号 48075

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

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

1
2
3
4
5
6
7
8
{
"type": "sp_ala",
"srcid": "48075",
"surface": "mobile",
"intent": {
"name_id": ""
}
}

从 webhook 返回的结果

外层通用数据字段

key 类型 含义 示例/说明
status integer 结果状态码,0 代表正确,1 代表无结果,
2 代表请求参数错误,3 代表内部服务错误
0
msg string 出错消息,当非 0 时提供 “”
data object 要返回的资源数据内容 JSON 对象,每个资源分类不同

当前资源分类的dataobject字段内容

key 类型 要求 说明
adjective string 必选 类目名称,固定为:公司店铺起名,最短1个字符,最长10个字符
jump_url string 必选 点击卡片标题的跳转路径,跳转至资源方能够进行公司店铺起名的落地页。如果收到的surface请求是mobile,请返回小程序路径,如/page/of/target;如果收到的surface请求是web_h5,请返回H5路径,如/page/of/target(以/开头,不含域名)
tag array 可选 等分Tag 列表,最少3个,最多5个,最少3个,最多5个
tag.text string 可选,选后不可为空 tag文案,最短1个字符,最长6个字符
tag.url string 可选 tag链接地址。如:“/page/of/target”
submit_url string 必选 表单提交按钮的路径,点击“一键获取名字”按钮的跳转路径,跳转至计算结果页。以“/page/of/target?param1={{val1}}&param2={{val2}}”形式上传,param1、param2、分别对应落地页获取用户选择的公司行业、起名字数的key,可根据需要改写为具体的名称,{{val1}}、{{val2}}、 是固定字符,会替换为用户输入的具体数值,请不要修改。
item1 string 必选 第一个选择表单名称,最多4个字,如:公司行业,最短1个字符,最长4个字符
options1 array 必选 公司行业选项列表 ,最少2组,最多25组
options1.text string 必选 选项文案,如:互联网行业,最短1个字符
options1.value string 必选 选项值,各选项对应的计算数值,最短1个字符
item2 string 必选 第二个选择表单名称,最多4个字,如:名字字数,最短1个字符,最长4个字符
options2 array 必选 名字字数选项列表,最少2组,最多25组
options2.text string 必选 选项文案,如:两个字,最短1个字符
options2.value string 必选 选项值,各选项对应的计算数值,最短1个字符
button_text string 必选 按钮文案,最多6个字,如:“一键获取名字”,最短2个字符,最长6个字符
slink array 可选 子链列表,最少2个,最多3个,最少2个,最多5个
slink.text string 可选,选后不可为空 子链文案,最短1个字符,最长6个字符,最短1个字符,最长10个字符,例如:子链
slink.url string 可选 子链跳转链接,例如:’/page/of/target?id=1’
statement string 可选,选后不可为空 底部声明文案,对公司店铺起名卡片的说明,不超过24个字符,最短1个字符,最长100个字符

举例:从 webhook 返回的 JSON (加密前)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
{
"status": 0,
"msg": "",
"data": {
"adjective": "公司店铺起名",
"jump_url": "/page/of/target?id=1",
"tag": [{
"text": "互联网公司",
"url": "/page/of/target?id=1"
}, {
"text": "互联网公司",
"url": "/page/of/target?id=1"
}, {
"text": "互联网公司",
"url": "/page/of/target?id=1"
}],
"submit_url": "/page/of/target?param1={{val1}}&param2={{val2}}",
"item1": "公司行业",
"options1": [{
"text": "互联网公司",
"value": "beijing"
}, {
"text": "互联网公司",
"value": "beijing"
}, {
"text": "互联网公司",
"value": "beijing"
}],
"item2": "名字字数",
"options2": [{
"text": "两个字",
"value": "两个字"
}, {
"text": "两个字",
"value": "两个字"
}, {
"text": "两个字",
"value": "两个字"
}],
"button_text": "一键获取名字",
"slink": [{
"text": "详细公司起名",
"url": "/page/of/target?id=1"
}, {
"text": "详细公司起名",
"url": "/page/of/target?id=1"
}],
"statement": "一键智能订制公司名"
}
}

反 馈帮 助 回 到顶 部