文档首页/ 云空间服务 KooDrive/ API参考（运营商）/ API/ 分享管理-访问链接-公开/ 单文件下载 - downloadShareFilePublic
更新时间：2026-04-16 GMT+08:00
查看PDF
分享

单文件下载 - downloadShareFilePublic

功能介绍

获取分享链接里单文件的下载地址（该功能目前只有白名单用户使用）

授权信息

当前API调用无需身份策略权限。

URI

POST /koodrive/ose/v1/share/public/download

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Traceid

否

String

参数解释：

业务跟踪id（必须58位）

约束限制：

不涉及

取值范围：

长度为58位

默认值：

不涉及

language

否

String

参数解释：

国际化语言标识

约束限制：

符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语

取值范围：

不涉及

默认值：

en-US

X-Hw-Agentname

是

String

参数解释：

运营商名称

约束限制：

不涉及

取值范围：

不涉及

默认值：

不涉及
表2 请求Body参数

参数

是否必选

参数类型

描述

shareId

是

String

参数解释：

分享ID

约束限制：

不涉及

取值范围：

不涉及

默认值：

不涉及

kdstoken

否

String

参数解释：

分享临时token

约束限制：

不涉及

取值范围：

不涉及

默认值：

不涉及

fileId

是

String

参数解释：

希望下载的文件ID

约束限制：

不涉及

取值范围：

不涉及

默认值：

不涉及

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

code

Integer

响应码

msg

String

响应信息

downloadUrl

String

下载地址

请求示例

/koodrive/ose/v1/share/public/download

{
  "shareId" : "1808628918186415616",
  "fileId" : "FumFysUZDLUEAGaRDVyFC76wn87hIwVpB",
  "kdstoken" : ""
}

响应示例

状态码：200

OK

{
  "downloadUrl" : "https://obs-koodrive-obs.cn-north-4.myhuaweicloud.com/a*********************************ers=host&X-Amz-Expires=3600&X-Amz-Credential=CKJ3TYZ9M7QPX4SXS3",
  "code" : 0,
  "msg" : "成功"
}

状态码

状态码

描述

200

OK