appidstring必填青鸾实例 ID,形如 we_xxxxxxxxxxxxxxx。在开发者控制台「实例与回调」扫码上号后获得。
"we_xxxxxxxxxxxxxxx"下载大文件。fileId 用 BigFileUploadCompleted 回调事件里的 content.id;不需要 aesKey,这点与普通媒体下载不同。
/qingluan/api/cdn/downloadBigFile下载大文件。fileId 用 BigFileUploadCompleted 回调事件里的 content.id;不需要 aesKey,这点与普通媒体下载不同。
请求体必填。通过 QL-Key 请求头携带 APIKey。
Content-Type:application/json
请求参数。字段名区分大小写,请按文档原样传递。
appidstring必填青鸾实例 ID,形如 we_xxxxxxxxxxxxxxx。在开发者控制台「实例与回调」扫码上号后获得。
"we_xxxxxxxxxxxxxxx"fileIdstring必填文件资源 ID
大文件 ID,取自 BigFileUploadCompleted 回调事件的 content.id(*1* 开头)。大文件下载不需要 aesKey,与普通媒体下载的方式不同。
"*1*JeQaS7p9xyBzZDMi7cE4ERZgYE9WBxQSTWLkb3GTSI4KilH7vStlu8CZ7vWH4QgU6b0a02a/TtoXxh23J0nprjjHerhYvKajA32+HmrodhavWTB3lkR9W/UnN1r3tsoh93xR/BPdRyBdGo5LBIlB2AfN1qUVLAKoxuEBKS/86mP1C+MkUBtWITUzV1rCJ/SX7nHtW"fileNamestring必填文件名
文件名,取自 BigFileUploadCompleted 回调事件的 content.name。
"random_20mb_20260727.txt"本接口为能力层原样返回,不统一增加青鸾外层信封。code = 0 仅表示请求被接受,不保证副作用已完成。
请结合业务数据与本页说明判断实际状态,不要仅凭响应码推断操作效果。
能力层原样返回;code = 0 仅表示请求已受理,业务结果须按接口说明确认。
application/json
接口原样返回平台的业务响应。HTTP 状态码与业务状态码需分别判断:HTTP 200 只表示请求已送达,成功以 code = 0 为准。
codeinteger必填业务状态码
业务状态码:0 表示成功,-1 表示失败;失败原因见 message。
0dataobject可选业务数据
业务返回数据;字段结构见下方定义。
base64string可选文件内容的 Base64 编码,不带 data: 前缀
注意:完整文件内容的 Base64(不带 data: 前缀)。58KB 文件返回 77,840 字符,与上传 fileSize=58378 吻合。响应体是文件大小的 4/3,只验证到 58KB 量级。
serverAddrstring可选大文件所在的下载服务地址。
注意:本次命中的 CDN 边缘节点 ip:port,随次变化,仅供排障,不要缓存。
detailstring可选错误详情
错误详情;无补充信息时通常为空字符串。
messagestring必填响应消息
业务结果消息。成功通常为 ok;企微错误通常为 错误码|错误信息。
"ok"timestring必填服务端时间
服务端时间,格式为 YYYY-MM-DD HH:mm:ss。
"2026-07-21 07:33:17"受控接口,需通过控制台配置
appid 不存在或无权访问