# 技能商店
# 获取技能列表
HTTP Method:GET
请求地址:https://uvs-biz.hivoice.cn/rest/v1/skill/skill_list
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| appkey | String | Y | 产品KEY |
| deviceId | String | Y | 设备标识 |
| deviceToken | String | Y | 设备令牌 |
| userId | String | Y | 用户ID |
| pageNo | Integer | N | 页码 |
| pageSize | Integer | N | 数量 |
返回值
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| errorCode | String | Y | 响应code,成功为0,具体见错误码定义 |
| errorMsg | String | Y | 响应描述 |
| result | Object | Y | 返回的结果数据 |
| └pageSize | Integer | Y | 数量 |
| └pageNo | Integer | Y | 页数 |
| └total | Integer | Y | 数据总数 |
| └list | array | Y | 数据集合 |
| └└icon | String | Y | 技能图标 |
| └└name | String | Y | 技能名称 |
| └└sentences | Array | Y | sentences |
| └└service | String | Y | service,形如:cn.usk.music |
| └└skillId | String | Y | 技能ID |
| └└skillSource | String | Y | 技能来源(1:云知声 2:合作方 3:普通开发者) |
| └└skillVersion | String | Y | 技能版本号,形如:1.0 |
| └└type | Integer | Y | 类型(1:自定义 2:智能问答 3:智能播报) |
| └└userId | Integer | Y | 开发者用户编号 |
| └└userName | String | Y | 开发者名称 |
| └└userNameAbbr | String | Y | 开发者简称 |
返回结果示例:
{
"errorCode": "0",
"errorMsg": "请求成功",
"result": {
"list": [
{
"icon": "http://dcs-resources-oss.hivoice.cn/skill/icon/music_kuwo.png",
"name": "音乐点播(酷我)",
"sentences": [
"我想听刘德华的忘情水",
"我想听王菲的歌曲"
],
"service": "unios.usk.unisound.music.kuwo",
"skillId": "9fc6a0b2c5cf4dd881c7cf4dda1e27ec",
"skillSource": "1",
"skillVersion": "1.0.5",
"status": 11,
"type": 1,
"userId": 15966,
"userName": "云知声智能科技股份有限公司",
"userNameAbbr": "云知声"
},
{
"icon": "https://unios-usk.oss-cn-beijing.aliyuncs.com/skill/icon/zhangguan.png",
"name": "KBQA行政长官",
"sentences": [
"现任北京市市长是谁",
"北京市市委书记是谁",
"北京市上一任市长是谁",
"河北省省委书记",
"河北省上一任省委书记"
],
"service": "unios.usk.unisound.kbqa.commander",
"skillId": "600019",
"skillSource": "1",
"skillVersion": "1.0.0",
"status": 13,
"type": 1,
"userId": 0,
"userName": "云知声智能科技股份有限公司",
"userNameAbbr": "云知声"
}
],
"pageNo": 1,
"pageSize": 2,
"total": 12
}
}
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
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
# 获取技能详情
HTTP Method:GET
请求地址:https://uvs-biz.hivoice.cn/rest/v1/skill/skill_detail
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| appkey | String | Y | 产品KEY |
| deviceId | String | Y | 设备标识 |
| deviceToken | String | Y | 设备令牌 |
| userId | String | Y | 用户ID |
| id | String | Y | 技能id(列表中的skillId) |
返回值
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| errorCode | String | Y | 响应code,成功为0,具体见错误码定义 |
| errorMsg | String | Y | 响应描述 |
| result | Object | Y | 返回的结果数据 |
| └categoryId | Integer | Y | 类别ID |
| └icon | String | Y | 技能图标 |
| └name | String | Y | 技能名称 |
| └sentences | Array | Y | 常用表达语句列表(有序) |
| └service | String | Y | service,形如:cn.usk.music |
| └skillId | String | Y | 技能ID |
| └skillSource | String | Y | 技能来源(1:云知声 2:合作方 3:普通开发者) |
| └skillVersion | String | Y | 技能版本号,形如:1.0 |
| └type | Integer | Y | 类型(1:自定义 2:智能问答 3:智能播报) |
| └userId | Integer | Y | 开发者用户编号 |
| └userName | String | Y | 开发者名称 |
| └userNameAbbr | String | Y | 开发者简称 |
| └gmtCreate | Long | Y | 创建时间 |
| └gmtModified | Long | Y | 更新时间 |
返回结果示例:
{
"errorCode": "0",
"errorMsg": "请求成功",
"result": {
"categoryId": 30,
"gmtCreate": 1576747134000,
"gmtModified": 1578277729000,
"icon": "https://unios-usk.oss-cn-beijing.aliyuncs.com/skill/icon/zhangguan.png",
"name": "KBQA行政长官",
"sentences": [
"现任北京市市长是谁",
"北京市市委书记是谁",
"北京市上一任市长是谁",
"河北省省委书记",
"河北省上一任省委书记"
],
"service": "unios.usk.unisound.kbqa.commander",
"skillId": "600019",
"skillSource": "1",
"skillVersion": "1.0.0",
"status": 13,
"type": 1,
"userId": 0,
"userName": "云知声智能科技股份有限公司",
"userNameAbbr": "云知声"
}
}
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
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
# 错误码定义及描述
| errorCode | errorMsg | 描述 |
|---|---|---|
| 0 | 请求成功 | 成功 |
| 8400001 | 必填参数不能为空 | 必填参数不能为空 |
| 8400002 | 请求参数不合法 | 请求参数格式不正确,或者参数不满足需要的条件 |
| 8400003 | 设备token无效 | 设备token无效 |
| 8400005 | 未发现需要更新的唤醒词 | 上传的唤醒词都在使用中 |
| 8400006 | 未发现设备sdk版本 | |
| 8401001 | 唤醒词打分异常 | 唤醒词打分异常 |
| 8401002 | 唤醒词正在制作中 | 唤醒词正在制作中 |
| 8404444 | 调用第三方服务异常 | 调用第三方服务异常 |
| 8409999 | 系统异常 | 联系管理员 |