访问预览文件

GET

/sdk/v2/api/cloud-files/{fileID}/page

用于在浏览器上渲染出预览的页面，需要嵌入Iframe使用。

只读模式访问协同文档

参考预览协同文档流程，后续说明仅针对预览文档

此接口依赖的回调接口

获取文件元信息-预览文档
获取当前用户信息

对于同一个文件，第一次调用该接口时，后台会异步调用创建文件预览缓存接口创建任务，创建成功后才会渲染出预览页面。

预览加速

如果需要加快第一次打开文件的速度，可在服务端提前调用创建文件预览缓存接口创建预览缓存，这样可以使用户打开预览时无需等待。

预览缓存

由于预览缓存机制，同一fileId经过第一次预览产生预览缓存后，再自定义更新回调中downloadUrl内容是无法修改预览结果的。

不支持预览0kb大小的文件

方案一：用户直接访问（首次访问较慢）

方案二：服务端预热缓存（推荐方案）

嵌入 iframe 使用示例：

请求参数

Path 参数

Query 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request GET '/sdk/v2/api/cloud-files/cae42842fa05446e/page?lang=zh-CN&signature={{signature}}&token={{token}}'

返回响应

🟢200成功

application/json

Body

示例

{}

修改于 2026-04-02 02:03:28

删除协同文档

创建文件预览缓存

访问预览文件

方案一：用户直接访问（首次访问较慢）#

方案二：服务端预热缓存（推荐方案）#

嵌入 iframe 使用示例：#

请求参数

请求示例代码

返回响应

方案一：用户直接访问（首次访问较慢）

方案二：服务端预热缓存（推荐方案）

嵌入 iframe 使用示例：