文档首页/云空间服务 KooDrive/API参考(运营商)/API/文件操作/获取分享文件在线预览链接 - GetShareFilePreviewUrl
更新时间:2026-02-03 GMT+08:00

获取分享文件在线预览链接 - GetShareFilePreviewUrl

功能介绍

获取外链分享文件在线预览的链接

授权信息

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

URI

GET /koodrive/ose/v1/files/preview/share/{shortcode}

表1 路径参数

参数

是否必选

参数类型

描述

shortcode

String

参数解释:

分享短链

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表2 Query参数

参数

是否必选

参数类型

描述

fileId

String

参数解释:

文件ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

kdstoken

String

参数解释:

短链校验码,分享详情查询接口返回

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

parentFolder

String

参数解释:

父目录ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Traceid

String

参数解释:

业务跟踪id(必须58位)

约束限制:

不涉及

取值范围:

长度为58位

默认值:

不涉及

language

String

参数解释:

国际化语言标识

约束限制:

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

取值范围:

符合i18n规范

默认取值:

en-US

X-Hw-Agentname

String

参数解释:

运营商名称

约束限制:

不涉及

取值范围:

不涉及

默认值:

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

code

Integer

响应码

msg

String

响应消息

link

String

文件在线预览连接地址

请求示例

获取短链分享码2dert45454下某个文件的预览链接

GET /koodrive/ose/v1/files/preview/share/2dert45454

响应示例

状态码:200

获取文件在线预览链接地址响应

{
  "link" : "https://xxxxxxx.obs.cn-north-4.myhuaweicloud.com/***********?response-content-disposition=attachment%3B%20filename%2A%3DUTF-8%27%27b112599cf0a74e7798fe9bd7e6725010.pdf&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20250924T093847Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=*************SA%2F20250924%2Fnorth-4%2Fs3%2Faws4_request&X-Amz-Signature=*******",
  "code" : 0,
  "msg" : "Success."
}

状态码

状态码

描述

200

获取文件在线预览链接地址响应