Skip to content

上传文件用于 Aily 的数据知识管理 ​

上传文件用于 Aily 的数据知识管理 。

Tip: - 仅支持开发环境

  • 开发者需要 Aily 创建平台的应用协作者角色,包括管理员、开发者、运维人员
  • 使用应用身份仅支持 Aily 平台渠道的应用身份
  • 仅支持上传docx、txt、pdf、pptx类型的文件

请求 ​

项目值
HTTP URLhttps://open.feishu.cn/open-apis/aily/v1/apps/:app_id/data_assets/upload_file
HTTP MethodPOST
接口频率限制5 次/秒
支持的应用类型custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用aily:data_asset:upload_file 上传数据知识文件

请求头 ​

名称类型必填描述
Authorizationstring是tenant_access_token 或 user_access_token 值格式:"Bearer access_token" 示例值:"Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token
Content-Typestring是示例值:"multipart/form-data; boundary=---7MA4YWxkTrZu0gW"

路径参数 ​

名称类型描述
app_idstringAily 平台的应用的APPID,可以直接从 Aily 应用的URL中获取。获取示例:/ai/{APPID}
示例值:"spring_dsafdsaf__c"
数据校验规则:
- 长度范围:0 ~ 255 字符

查询参数 ​

名称类型必填描述
tenant_typestring否应用环境,枚举值: - online:线上环境(默认值) - dev:开发环境;目前只支持 dev
示例值:dev
数据校验规则:
- 长度范围:0 ~ 255 字符

请求体 ​

名称类型必填描述
filefile是需要上传的文件。仅支持上传 docx、txt、pdf、pptx 类型的文件。
示例值:file binary

请求体示例 ​

HTTP
---7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file";
Content-Type: application/octet-stream


---7MA4YWxkTrZu0gW

响应 ​

响应体 ​

名称类型描述
codeint错误码,非 0 表示失败
msgstring错误描述
data\--
  └ file_infodata_asset_file数据知识文件
    └ tokenstring数据知识文件 token
    └ mime_typestring解析出的文件类型,包括pdf、docx、pptx、txt

响应体示例 ​

json
{
    "code": 0,
    "msg": "success",
    "data": {
        "file_info": {
            "token": "file_token_abcd123",
            "mime_type": "application/pdf"
        }
    }
}

错误码 ​

HTTP状态码错误码描述排查建议
4002700001param is invalid参数错误,请结合说明文档排查
4032701004permission denied无权限,请检查是否有开发者或者运维权限
4002700026only support development environment仅支持开发环境操作
4002700035the file size exceeds 50M上传文件大小超过50M
4002700034unsupported file type不支持的文件类型
4002700027only upload one file is supported仅支持上传单个文件
4002700472some param miss or invalid部分参数缺失或者不合法,请结合文档排查

内容来源:飞书开放平台 · 自动爬取整理