生成文件上传预签名地址 本文介绍生成文件上传预签名地址内容。 接口描述 获取向知识库上传文件的存储预签名上传地址 请求方法 POST 接口要求 无 URI /openapi/v1/documents/uploadFilePreSignUrl 请求参数 请求头header参数 参数 是否必填 参数类型 说明 示例 下级对象 ContentType 是 String json格式 application/json tenantId 是 String 租户ID 562b89493b1a40e1b97ea05e50dd8170 ctyuneoprequestid 是 String 用户请求 id,由用户构造,用户可以通过 uuid 等方法自行生成唯一字符串,用于日志请求追踪 33dfa732b27b464fb15a21ed6845afd5 eopdate 是 String 请求时间,由用户构造,形如 yyyymmddTHHMMSSZ。 20211221T163014Z host 是 String 终端节点域名,固定字段 kqaglobal.ctapi.ctyun.cn EopAuthorization 是 String 由天翼云官网 accessKey 和 securityKey 经签名后生成,参与签名生成的字段包括天翼云官网 accessKey 、securityKey、平台应用的appkey(非必须),用户请求id(非必须),请求时间,终端节点域名(非必须)以及请求体内容。 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 infoBaseId 是 Int 目标知识库ID files 是 Array 要上传的文件信息 file file表 参数 是否必填 参数类型 说明 示例 下级对象 fileName 是 String 文件名称 测试.pdf fileSize 是 Int 文件大小,字节 129212 chunkConfig 否 Object 文档切分策略 详情见“创建知识库”接口的chunkConfig对象定义 请求代码示例 plaintext Curl X POST " H "ContentType: application/json" H "ctyuneoprequestid:33dfa732b27b464fb15a21ed6845afd5" H "tenantId:XXX" H "EopAuthorization:XXX" H "eopdate:20211109T104641Z" H "host:kqaglobal.ctapi.ctyun.cn" data '{ "infoBaseId": 10, "files": [ { "fileName": "测试.pdf", "fileSize": 129212 } ] }' 返回值说明 1.请求成功返回响应参数 参数 参数类型 说明 示例 下级对象 statusCode String 返回状态,返回200表示成功 200 message String 返回Success Success returnObj Array 接口返回结果 returnObj表 returnObj表 参数 参数类型 说明 示例 下级对象 fileName String 文件名 测试.pdf fileSize Int 文件大小 129212 url String 上传文件预签名地址 infoBaseId Int 知识库ID 100 userId String 用户ID 6065e0f9b70e4b7dcdcfaac9543afd23 chunkConfig Object 文档切分策略 详情见“创建知识库”接口的chunkConfig对象定义 2.请求失败返回响应参数 参数 参数类型 说明 示例 下级对象 statusCode String 错误码,放置API对应的错误码 40001 message String 失败信息 缺少鉴权信息 error String 返回对应的错误码 KQA40001 返回值示例 1.请求成功返回值示例 plaintext { "statusCode": "200", "error": null, "message": "Success", "returnObj": [ { "fileName": "测试.pdf", "fileSize": 129212, "url": " "infoBaseId": "100", "userId": "6065e0f9b70e4b7dcdcfaac9543afd23" } ] } 2.请求失败返回值示例 plaintext { "statusCode": "40004", "error": "KQA40004", "message": "接口执行异常" } 状态码 http状态码 描述 200 表示请求成功 错误码说明 错误码 错误信息 错误描述 40005 知识库不存在 未查询到可用知识库 40015 执行异常 具体错误见message字段 40018 文件大小超过限制 txt文件限制1MB,其他文件限制50MB