会话绑定文件
更新时间：2026-10-13
POST
https://api.dumate.cn/api/v1/sessions/{sessionId}/files
本接口用于将已通过上传文件接口上传的文件挂载到指定会话（Session）的 CFS files 目录，使百度搭子在该会话中可直接访问这些文件。
每次请求最多挂载 100 个文件。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
URL 参数
sessionId
string
待挂载文件的会话（Session）标识。
必选
Body 参数
fileIDs
array
需要挂载的文件标识列表。
最大 100 个。
必选
显示子属性
隐藏子属性
items
string
请求结构
POST /api/v1/sessions/ses_01ABC/files HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
{
"fileIDs": [
"fil_demo_3bd291",
"fil_demo_4ac512"
]
}示例代码
请求示例
curl --location --request POST "https://api.dumate.cn/api/v1/sessions/ses_01ABC/files" \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--data '{
"fileIDs": [
"fil_demo_3bd291",
"fil_demo_4ac512"
]
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
sessionId
string
本次挂载对应的会话（Session）标识。
可选
mounted
array
成功挂载的文件列表。
可选
显示子属性
隐藏子属性
items
object {2}
显示子属性
隐藏子属性
fileID
string
文件标识。
可选
path
string
文件在 CFS 上的挂载路径。
可选
failed
array
挂载失败的文件列表。
可选
显示子属性
隐藏子属性
items
object {2}
显示子属性
隐藏子属性
fileID
string
文件标识。
可选
reason
string
挂载失败原因。
可选
响应示例
{
"sessionId": "ses_01ABC",
"mounted": [
{
"fileID": "fil_demo_3bd291",
"path": "/cfs/files/document.txt"
}
],
"failed": [
{
"fileID": "fil_demo_4ac512",
"reason": "file not found"
}
]
}评价此篇文章