智能小程序OPENCARD
开放类目

公司高管

用户在搜索公司高管需求时,搜索展现公司高管卡片,提供直观结构化的公司高管内容。

示意图

intent 上传接口

当前资源 intent 意图参数

key 类型 含义 示例/说明
company string 公司名/集团名/品牌名 公司名:”深圳市腾讯计算机系统有限公司” “北京百度网讯科技有限公司”
集团名:”腾讯” “百度” “字节跳动”
品牌名:”抖音” “uc浏览器”

通过平台上传 txt 文件

资源方需要将自己小程序能够覆盖的所有 intent 参数组合通过 txt 文件上传到平台上,txt 文件的具体要求参见接入流程-上传 Intent 数据

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

1
2
3
{"company":"深圳市腾讯计算机系统有限公司"}
{"company":"字节跳动"}
{"company":"UC浏览器"}

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

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

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

1
2
3
4
5
6
7
8
{
"type": "sp_ala",
"srcid": "48112",
"surface": "mobile",
"intent": {
"company":"深圳市腾讯计算机系统有限公司"
}
}

从 webhook 返回的结果

外层通用数据字段

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

当前资源分类的 data object 字段内容

key 类型 要求 说明
jump_url string 必选 点击卡⽚标题的跳转路径,应跳转资源方落地页,该落地页应含有公司高管信息。
如果收到的surface请求是moblie,请返回小程序路径,例如:/page/of/target;
如果收到的surface请求是web_h5,请返回H5路径,如/page/of/target(以/开头,不含域名)
baseData array 必选 基础数据列表,最少1个,最多3个
baseData.titleS string 必选 公司名/品牌名/集团名,尽量<15字,否则会截断
例如:
公司名”深圳市腾讯计算机系统有限公司”
集团名”腾讯” “百度” “字节跳动”
品牌名:”抖音” “uc浏览器”
baseData.titleP string 必选 高管信息标题,尽量<5字,否则会截断,例如:主要人员
formData array 必选 高管信息数据列表,数据可传最少2个,最多50个;
但卡片最多支持展现3个,数据超过3个省略且展现查看更多
formData.imgUrl string 必选 高管头像,分辨率要高于364*364px,比例长:宽=1:1
formData.name string 必选 高管名字,尽量<6字,否则会截断,例如:马化腾
formData.description string 必选 高管描述,尽量<50字,若无描述则数据内容为“暂无简介“,例如:马化腾,腾讯主要创办人之一,董事会主席兼首席执行官,腾讯产业共赢基金创始合伙人&董事会主席兼首席执行官。
formData.position string 必选 高管职位,尽量<15字,,否则会截断,若一名高管有多个职位,职位间用空格分隔,例如:董事会主席 CEO

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
"status": 0,
"msg": "string",
"data": {
"jump_url": "/page/of/target",
"baseData": [
{
"titleS": "腾讯",
"titleP": "高管"
}
],
"formData": [
{
"imgUrl": "https://img5.tianyancha.com/logo/human/2/9657e68b874004f0830a49ad3b352e75.png",
"name": "马化腾",
"description": "马化腾,腾讯主要创办人之一,董事会主席兼首席执行官,腾讯产业共赢基金创始合伙人&董事会主席兼首席执行官。",
"position": "董事会主席 CEO"
}
]
}
}

审核常见问题

三类intent对应的数据问题

company有三类:公司名/品牌名/集团名,三者对应的数据格式一致,但具体内容要求不同

三类具体区分方法和对应的内容要求如下

  • 公司名为具体某家公司,例如:需求为腾讯计算机系统有限公司高管;要求内容为该具体公司的高管名单
  • 集团名为大众认知上集团名称,一般为多家公司集合,例如腾讯高管、百度高管;要求内容为集团的高管名单
  • 品牌名为大众认知上品牌名称,例如:抖音高管、作业帮高管;要求内容为该品牌对应背后集团/公司的高管名单

高管排序要求与公司/集团内实际职级大小排序一致(实际职级大小以官网为准)

反 馈帮 助 回 到顶 部