获取知识库分类列表

最近更新时间:2019-08-30 15:53:19

功能描述

用户可以获取知识库的分类列表。

请求

请求 URL

https://yun.tim.qq.com/v3/prophet/get_class_list?
appid=$appid
&sdkappid=$sdkappid
&identifier=$identifier
&usersig=$usersig
&random=999999
&contenttype=json 

URL 详细字段说明请参阅 URL 字段说明 文档。

请求参数

字段名称 描述 类型 必填
botid 机器人唯一标识,由用户指定。 String
auth 第三方帐号认证信息,用作回调验证第三方帐号合法性。 String
level 获取的分类列表所在级别,可取值为 1、2、3 共 3 级分类。 Int
parent_classid 获取的分类列表所在父节点分类 ID,如果获取所有 1 级分类列表,则填 0。 Int
qa_count 请求中带该参数,则返回分类下知识点数量。默认不返回知识点数量。 Int

响应

响应参数

字段名称 描述 类型
ActionStatus 处理状态 OK:成功;FAIL:失败。 String
ErrorCode 错误码,0:成功;非0:失败。 Int
ErrorInfo 错误信息 String
classlist 分类信息列表 String
classid 分类 ID String
classname 分类名称 String
qa_count 分类下知识点数量 Int

示例

请求示例

https://yun.tim.qq.com/v3/prophet/get_class_list?
appid=$appid
&sdkappid=$sdkappid
&identifier=$identifier
&usersig=$usersig
&random=999999
&contenttype=json 

{
    "auth": "", 
    "botid": "bot_identifier",
    "level": 1,
    "parent_classid": "0",
    "qa_count": 0
}

响应示例

{
    "ActionStatus": "ok", 
    "ErrorCode": 0, 
    "ErrorInfo": "",
    "classlist":
    [
        {
            "classid": "100000",
            "classname": "class1",
            "qa_count": 1
        }
    ]
}