开发工具

访问预览文档

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

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

对于同一个文件，第一次调用该接口时，后台会异步调用创建预览接口创建任务，创建成功后才会渲染出预览页面。如果需要加快第一次打开文件的速度，可在服务端提前调用创建预览接口创建预览。

嵌入 iframe 使用示例：

<html>
  <head>
    <!-- some code -->
  </head>
  <body>
    <!-- your HTML elements -->
    <div id="shimo-sdk-preview" class="shimo-sdk-preview">
      <iframe
        src="https://shimo-domain/sdk/v2/api/cloud-files/acd87e72-946c-4182-b864-f1a7e9c74ddb/page?signature=your_signature&token=your_token&lang=zh-CN"
        style="border: none; overflow: hidden;"
      ></iframe>
    </div>
  </body>
</html>

请求参数

Path 参数

fileID

string

必需

文件 ID 位于创建预览接口的 URL 路径中，此文件 ID 为接入服务商文件列表中的唯一 ID，石墨会根据此 ID 请求接入服务商的文件接口获取文件信息和下载地址

示例值:

cae42842fa05446e

Query 参数

lang

string

可选

页面中的语言设置，默认zh-CN，可选 en-US，ja-JP

示例值:

zh-CN

signature

string

必需

接入方根据自己 app_id 和 app_secret 生成的 signature

示例值:

token

string

必需

接入方自定义的 token

示例值:

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

object {0}

{}

最后修改时间： 9 个月前