​

一、指令概述

该 RPA 指令用于将本地文件上传至飞书云盘指定文件夹，执行后返回上传文件的唯一标识（file_token），适用于本地文件的飞书云盘备份、自动化上云等场景。 飞书官方开发文档参考：https://open.feishu.cn/document/server-docs/docs/drive-v1/upload/upload_all

​

二、调用参数配置示意

参数名称示例 / 默认值说明指令上传文件固定选择 “上传文件”，执行本地文件飞书云盘上传操作。飞书访问凭证飞书访问凭证配置飞书开放平台的访问凭证（需具备文件上传权限，可通过 “获取飞书访问凭证” 指令生成），支持变量（界面显示 “{x}” 标识）。文件夹 Tokenfldbc****************输入目标文件夹的唯一标识 Token（需为飞书云盘合法文件夹 Token），关键字符已打码，支持变量。文件路径（如 “C:\Reports\ 报表.xlsx”）选择本地待上传文件的路径，可点击 “选择文件” 按钮选取，支持变量。生成的变量 - 运行结果变量（自定义变量名）存储文件上传操作的执行结果（包含上传后文件的file_token），需配置为自定义变量，后续流程可调用，支持变量。

​

三、使用示例（本地文件上传至飞书云盘场景）

​

场景：将本地文件 “报表.xlsx” 上传至飞书云盘目标文件夹（Token：fldbc****************）。

​

参数配置：

• 指令：上传文件 • 飞书访问凭证：feishuAuthToken（通过 “获取飞书访问凭证” 指令生成的变量） • 文件夹 Token：fldbc****************（目标文件夹唯一标识，关键字符已打码） • 文件路径：C:\Reports\报表.xlsx（本地待上传文件路径） • 运行结果：uploadResult（自定义变量，存储上传结果）

​

执行流程：

调用该 RPA 指令后，RPA 会通过 feishuAuthToken 完成飞书 API 认证，根据打码后的文件夹 Token 和本地文件路径，将文件上传至飞书云盘指定文件夹；上传完成后，将包含file_token的结果存入 uploadResult 变量，便于后续文件管理（如移动、分享）等操作引用该文件标识。

​

四、返回结果说明

​

飞书 API 标准返回示例（成功场景）：

指令执行后，“运行结果” 变量（如uploadResult）会存储包含上传文件标识的 JSON 结果，格式如下： { “code”: 0, “msg”: “success”, “data”: { “file_token”: “boxcnrHpsg1QDqXAAAyachabcef” }}

​

响应字段含义：

• code：状态码，0 表示文件上传成功，非 0 为失败（具体错误码含义参考飞书官方文档）。 • msg：提示信息，success 表示上传成功。 • data.file_token：上传后文件的唯一标识 Token，是飞书云盘操作该文件的核心身份标识（如后续移动、删除文件需引用此 Token）。

​

五、注意事项

1. 访问凭证权限：“飞书访问凭证” 需具备文件上传权限（如 “Upload file” 权限）且未过期，否则会返回 code=403（权限不足）错误。
2. 文件夹 Token 有效性：文件夹Token 需为飞书云盘合法存在的文件夹 Token（打码不影响实际值校验），否则会返回 code=404（目标文件夹不存在）错误。
3. 文件路径合法性：本地 “文件路径” 需指向真实存在的文件（避免选择快捷方式或不存在的路径），否则会返回文件读取失败错误。
4. 上传限制：飞书 API 对上传文件的大小、格式有一定限制（具体参考飞书官方文档），超出限制会导致上传失败，需提前确认文件符合要求。

​

六、延伸应用

可结合 RPA 的 “新建文件夹”“移动文件” 指令，实现本地文件自动化云盘管理：例如本地生成日报表后，自动调用 “上传文件” 指令将其上传至飞书临时文件夹，再调用 “移动文件” 指令将其移动到 “日报表归档” 文件夹，替代人工手动上传和整理的重复工作，提升文件上云效率。