本文档由石墨办公提供。

访问预览文件

GET

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

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

只读模式访问协同文档

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

此接口依赖的回调接口

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

预览加速

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

预览缓存

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

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

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

Path 参数

Query 参数

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

🟢200成功

text/html

修改于 2026-09-15 02:46:52