文件导入说明

概述

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

接口1-创建导入任务

接口2-轮询查询导入进度

详细流程

导入流程图

导入时序图

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-06-22 02:43:30

删除协同文件

创建导入任务