本文档由石墨办公提供。

创建导出任务

POST

/sdk/v2/api/files/v1/export/{fileId}

将在线编辑文件导出为 Office 文件、PDF 等格式，不同套件支持的导出格式有所不同。

导出文件过程是一个异步处理过程，接口请求成功仅代表导出服务收到并开始处理导出请求，实际是否成功需要轮询获取导出进度接口查询导出任务是否完成。当任务完成后，用「获取导出进度」返回的链接 ( data.downloadUrl 字段) 下载文件。

此接口允许同时将同一个石墨文件导出为不同的文件类型，例如：同时将轻文档导出为 PDF 和 Word 两个格式。任务执行的最长时间为 10 分钟。

导出支持的文件格式

石墨文件类型	默认导出的文件类型	支持导出的文件类型
document	docx	docx, md, jpg, pdf
documentPro	docx	docx, pdf, wps
spreadsheet	xlsx	xlsx
presentation	pptx	pptx, pdf
table	xlsx	xlsx

请求参数

Path 参数

Header 参数

Body 参数application/json

示例

{
    "type": "xlsx",
    "enableImageFilter": true
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/sdk/v2/api/files/v1/export/1ab6ffd1930d627b' \
--header 'X-Shimo-Signature: {{signature}}' \
--header 'X-Shimo-Token: {{token}}' \
--header 'Content-Type: application/json' \
--data '{
    "type": "xlsx",
    "enableImageFilter": true
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "status": 0,
    "message": "",
    "data": {
        "taskId": "3oo4vnBJgcG5HxMm:1:603:docx"
    }
}

修改于 2026-06-22 02:43:30

文件导出流程

获取导出进度