# 技能商店

# 获取技能列表

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

# 获取技能详情

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

# 错误码定义及描述

errorCode errorMsg 描述
0 请求成功 成功
8400001 必填参数不能为空 必填参数不能为空
8400002 请求参数不合法 请求参数格式不正确,或者参数不满足需要的条件
8400003 设备token无效 设备token无效
8400005 未发现需要更新的唤醒词 上传的唤醒词都在使用中
8400006 未发现设备sdk版本
8401001 唤醒词打分异常 唤醒词打分异常
8401002 唤醒词正在制作中 唤醒词正在制作中
8404444 调用第三方服务异常 调用第三方服务异常
8409999 系统异常 联系管理员