文档导出流程

概述

文件导出采用异步处理模式，分为两个步骤：

接口1-创建导出任务：导出文件

接口2-轮询查询导出进度：获取导出进度

特别注意

应用表格：应用表格导出单独走导出应用表格为Excel

详细流程

导出流程图

导出时序图

1

创建导出任务

1.

接入方调用创建导出任务接口，上传需要导出的文件

2.

系统接收文件后，创建异步导出任务

3.

接口立即返回唯一的 taskId，用于后续查询进度

2

轮询查询进度

1.

接入方使用获得的 taskId 调用查询导出进度接口

2.

系统返回当前任务的状态信息，包括：

status：任务状态码（0表示正常，非0表示失败）

progress：导出进度（0-100，100表示完成）

3

结果判断

根据接口返回的状态信息，进行以下判断：
情况1：导出成功

当 status == 0 且 progress == 100 时，表示文件导出成功

此时文件已完全导出系统，可以正常使用

情况2：导出进行中

当 status == 0 且 progress < 100 时，表示任务正在处理中

建议等待适当时间（如3-5秒）后重新调用查询接口

持续轮询直到任务完成或失败

情况3：导出失败

当 status != 0 时，表示任务执行失败

接入方需要处理错误，可根据错误码进行相应处理

如需重试，可重新发起导出任务

使用建议

1.

轮询间隔：建议查询间隔不少于3秒，避免频繁请求

2.

超时处理：建议设置合理的总超时时间，避免无限等待

3.

错误重试：网络错误可重试查询，业务错误需要重新导出

4.

并发限制：同一接入方建议控制并发导出任务数量

特别注意

文件ID：导出、重新导出时必须使用不同的文件ID，石墨不支持对已存在的文件覆盖式导出

示例时序

修改于 2026-04-02 03:52:16

获取导入进度

创建导出任务