获取文件在线预览链接 - GetFilePreviewUrl
功能介绍
获取文件在线预览的链接
授权信息
当前API调用无需身份策略权限。
URI
GET /koodrive/ose/v1/files/preview/{fileId}/link
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
fileId | 是 | String | 参数解释: 文件id 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
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
参数 | 参数类型 | 描述 |
|---|---|---|
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 | 获取文件在线预览链接地址响应 |

