本文档由石墨办公提供。

导出文件

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, csv
presentation	pptx	pptx, pdf
table（≥CO-1.4版本支持）	xlsx	xlsx

提示

导出专业表格(spreadsheet)为 csv 时，必须传 exportSheetId 参数指定 sheetId

请求参数

Path 参数

Header 参数

Body 参数application/json

示例

{
    "type": "xlsx"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

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

修改于 2026-09-15 02:50:21

文件导出流程

获取导出进度