1. 功能说明
查询【任务 - 创建导入任务】生成的异步任务执行结果，获取文件导入状态（成功 / 处理中 / 失败）及导入后的云文档标识，底层基于飞书开放平台【查询导入任务结果】API（https://open.feishu.cn/document/server-docs/docs/drive-v1/import_task/get）实现。
2. 配置项说明
| 配置项 | 必填 | 默认值 | 说明 |
|---|---|---|---|
| 飞书访问凭证 | 是 | - | 选择与【创建导入任务】一致的飞书访问凭证，需确保权限有效。 |
| 任务 ID | 是 | - | 填写【创建导入任务】生成的任务ID（即飞书 API 返回的ticket），通常为变量形式（如变量21）。 |
| 任务状态 | 是 | - | 存储导入任务的当前状态，可选值：导入成功、处理中、导入失败。 |
| 导入云文档 Token | 是 | - | 若任务状态为 “导入成功”，存储生成的飞书云文档token；任务未完成时为空。 |
| 返回结果 | 是 | - | 存储查询请求的结果（字典类型），包含查询状态、错误信息等，格式参考下方 “返回结果示例”。 |
任务状态说明
| 状态值 | 含义 | 后续操作 |
|---|---|---|
| 处理中 | 导入任务仍在执行 | 等待一段时间后重新执行该查询指令，直到状态变为 “导入成功” 或 “导入失败”。 |
| 导入成功 | 文件已成功转为飞书云文档 | 通过 “导入云文档 Token” 访问 / 操作生成的云文档。 |
| 导入失败 | 导入过程出错 | 查看 “返回结果” 中的错误信息，根据提示修正问题后重新执行【创建导入任务】。 |
返回结果示例
- 查询成功（任务处理中）：
{
"success": true,
"data": {
"ticket": "task_1234567890abcdef",
"status": "processing"
},
"task_id": "task_1234567890abcdef"
}
- 查询成功（导入成功）：
{
"success": true,
"data": {
"ticket": "task_1234567890abcdef",
"status": "success",
"file_token": "doccnrHpsg1QDqXAAAyachabcef"
},
"task_id": "task_1234567890abcdef"
}
- 查询失败（任务不存在）：
{
"success": false,
"code": 1061003,
"msg": "任务不存在",
"log_id": "log_def456",
"raw_response": "{\"code\":1061003,\"msg\":\"任务不存在\",\"log_id\":\"log_def456\"}"
}
3. 示例场景
- 先执行【任务 - 创建导入任务】，生成
任务ID（存储到变量：任务ID）； - 执行本指令：
- 飞书访问凭证：选择与创建任务一致的凭证；
- 任务 ID：填写
变量：任务ID； - 任务状态：设置为
变量：任务状态； - 导入云文档 Token：设置为
变量：云文档Token； - 返回结果：设置为
变量：返回结果； - 检查任务的状态：若为 “处理中”，等待 5 秒后再次执行本指令；若为 “导入成功”，则通过
变量“云文档Token”获取云文档 Token。
4. 注意事项
常见问题
| 错误类型 | 可能原因 | 解决方案 |
|---|---|---|
| 任务 ID 不存在（API 错误码 1061003） | 任务 ID 填写错误，或任务已过期（飞书任务通常保留 7 天） | 核对【创建导入任务】生成的任务ID，若过期则重新创建导入任务。 |
| 权限不足（API 错误码 1061005） | 飞书应用未开通云文档查询权限 | 参考飞书权限配置文档，为应用添加 “云文档查看” 权限。 |
| 网络请求失败 | 网络波动或飞书 API 服务临时异常 | 重试查询指令，若多次失败可检查网络连接或飞书服务状态。 |