知识库文件导入

最近更新时间:2019-08-30 14:56:12

功能描述

上传知识库有两种方式,第一种通过 Rest API 的批量上传协议,单次最多上传 20 条。第二种是通过 excel 文件形式上传,单次最多上传1000 条。
通过 excel 文件形式上传需要特殊鉴权体系,建议通过控制台提交文件方式实现。

请求

请求 URL

https://yun.tim.qq.com/v3/prophet_upload/upload_qa_file?
appid=$appid
&sdkappid=$sdkappid
&identifier=$identifier
&usersig=$usersig
&random=9999
&botid=$botid
&contenttype=file 

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

请参数

该接口的请求体是 excel 文件的二进制信息。

响应

响应参数

字段名称 描述 类型
ActionStatus 处理状态 OK:成功;FAIL:失败。 String
ErrorCode 错误码,0:成功;非0:失败。 Int
ErrorInfo 错误信息 String
total_num 上传总条数 String
succeed_num 成功条数 String
fail_list 失败记录列表 String
fail_idx 对应 excel 的行号 String
error_code 上传错误码 String

示例

请求示例

https://yun.tim.qq.com/v3/prophet_upload/upload_qa_file?
appid=$appid
&sdkappid=$sdkappid
&identifier=$identifier
&usersig=$usersig
&random=9999
&botid=$botid
&contenttype=file 

(Multipart/form-data)

响应示例

{
    "ActionStatus": "ok", 
    "ErrorCode": 0, 
    "ErrorInfo": "",
    "total_num": 20, 
    "succeed_num": 20,
    "fail_list": 
    [
        {
            "fail_idx": 1,
            "error_code": 1
        },
        {
            "fail_idx": 1,
            "error_code": 1
        }
    ]
}