跳到主要内容

上传机器人文件

POST 

/api/open/v2/bot/files

上传图片或文件并获取 fileKey,用于 image/file 消息的 content。 fileKey 有效期约 10 分钟(expiresAt - now ≈ 600000 毫秒),过期后需重新上传。 单个文件上限 20 MiB,超出返回 HTTP 400、code 为 400006;整个请求体上限 22 MiB,超出返回 HTTP 413、code 为 413001。

⚠️ 签名第 8 行是实际发出的整个 multipart 请求体的 SHA-256,包含每个分片的 Content-Disposition/Content-Type 头、分隔符行 --<boundary>、以及收尾的 --<boundary>--\r\n。 因此不能直接 curl -F 'file=@a.png'——boundary 由 curl 随机生成,签名时无法预知那串字节,服务端会返回 401 + 400001(signature verification failed);这不是凭证或权限问题。 正确做法:自行按 --<boundary>\r\n + 分片头 + \r\n + 文件字节 + \r\n--<boundary>--\r\n 拼出确定字节的请求体,对拼好的字节算哈希并签名,再用 --data-binary @body.bin 原样发出。 完整字节布局、可直接复现的测试向量与 Python/curl 参考实现见鉴权与签名 → multipart 上传的签名。

Request​

Responses​

文件信息