通用文件上传
更新时间:2024-12-11
接口描述
该接口用于用户上传文件,文件上传之后获取的文件id可以在多个场景使用。目前只能提交到指定知识库,其它场景后续会陆续开放。
权限说明
Authorization需要填写密钥。
接口定义
Path | /v2/appbuilder?Action=UploadFile |
---|---|
Method | POST |
Content-Type | mutlipart/form-data |
Authorization | 请求签名(此签名为应用工作台密钥) |
请求结构
POST /v2/appbuilder?Action=UploadFile HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: authorization string
Content-Type: mutlipart/form-data
file="北京小学.docx"
请求头域
除公共头域外,无其它特殊头域。
请求参数
字段 | 类型 | 是否必须 | 说明 |
---|---|---|---|
file | file | 是 | 文件名限制命名不可包含 < > / \ | : " * ? 特殊符号,文件大小不能超过50MB |
响应头域
除公共头域外,无其它特殊头域。
响应参数
字段 | 类型 | 必然存在 | 说明 |
---|---|---|---|
requestId | string | 是 | requestId |
id | string | 是 | 已上传文件id |
name | string | 是 | 文件名称 |
请求curl 示例
curl --location 'https://qianfan.baidubce.com/v2/appbuilder?Action=UploadFile' \
--header 'Authorization: Bearer string' \
--form 'file=@"北京小学.docx"'
正确响应示例
HTTP/1.1 200 OK
{
"requestId": "355a4f4e-a6d8-4dec-b840-7075030c6d22",
"id": "1a1385ca-91ff-4b71-bb2a-048db17507c6",
"name": "北京小学.docx"
}
错误响应示例
HTTP/1.1 400
{
"requestId": "ae2225f7-1c2e-427a-a1ad-5413b762957d",
"code": "InvalidRequestArgumentError",
"message": "参数校验失败"
}