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

获取文件在线预览链接 - GetFilePreviewUrl

功能介绍

获取文件在线预览的链接

授权信息

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

URI

GET /koodrive/ose/v1/files/preview/{fileId}/link

表1 路径参数

参数

是否必选

参数类型

描述

fileId

String

参数解释:

文件id

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Authorization

String

参数解释:

该字段存储的是Access Token。调用KooDrive的API使用Token认证,拥有Token就代表拥有某种权限,在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Access Token的获取请参考对应的开发手册,格式参考:Bearer+{access_token}

约束限制:

不涉及

取值范围:

不涉及

默认值:

不涉及

X-Traceid

String

参数解释:

业务跟踪id(必须58位)

约束限制:

不涉及

取值范围:

长度为58位

默认值:

不涉及

language

String

参数解释:

国际化语言标识

约束限制:

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

取值范围:

符合i18n规范

默认取值:

en-US

X-Date

String

参数解释:

日期,用于app鉴权,格式为yyyyMMdd‘T’HHmmss‘Z’

约束限制:

距当前时间15分钟以内,不能晚于当前时间

取值范围:

不涉及

默认值:

不涉及

X-User-Id

String

参数解释:

KooDrive侧用户id,用于app鉴权

约束限制:

不涉及

取值范围:

不涉及

默认值:

不涉及

X-Share-Shorturl

String

参数解释:

分享短链

约束限制:

预览他人分享文件必传

取值范围:

不涉及

默认值:

不涉及

缺省值:

不涉及

X-Hw-Share-Folder-Id

String

参数解释:

共享文件夹ID,创建共享文件夹接口返回

约束限制:

预览共享文件夹下文件必传

取值范围:

不涉及

默认值:

不涉及

缺省值:

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

code

Integer

响应码

msg

String

响应消息

link

String

文件在线预览连接地址

请求示例

获取文件Fk__xUmqLFEABKbZAiqlHvYUoxViDiWNA在线预览的链接

GET /koodrive/ose/v1/files/preview/Fk__xUmqLFEABKbZAiqlHvYUoxViDiWNA/link

Authorization:Bearer+10f88*********4791e9ff

响应示例

状态码: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

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