千问办公企业旗舰版开发者文档:复制网盘文件。
认证方式见APP开发者文档 → 认证接入。
当前用户身份由 IAM 验证,Barn 执行文件归属与业务校验。不使用管理 API Key、Agent Token 或 OAuth 凭据替代,不自行设置 X-Gw 身份头。
目标仍以 path 指定;复制产生新的 file_id。按 ID 复制目录沿用原版上限 100 项(含根)及部分失败语义;结果未知或失败时先查询目标再重试。
200 返回裸 JSON 对象。
401 表示认证失败,403 表示资源权限拒绝;400/422 表示参数无效,404 表示当前用户资源不存在,409 表示冲突。依赖故障保持原错误,不伪造成功;503 为维护或依赖不可用,504 为请求超时。写操作结果未知时先查询资源状态,不盲目重复执行。
- 模块:文件
- 接口:POST
/api/openapi/app/v1/drive/copy/{path} - operationId:
app-post-copy-path
接口说明
当前用户身份由 IAM 验证,Barn 执行文件归属与业务校验。不使用管理 API Key、Agent Token 或 OAuth 凭据替代,不自行设置 X-Gw 身份头。
请求参数
| 字段 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| path | path | string | 是 | 目录/复制为整个 URL 编码的绝对逻辑路径;文件/Office 为 query 路径 |
| from_path | body | string | 二选一 | 当前用户源路径 |
| from_file_id | body | string (uuid) | 二选一 | 当前用户源文件/目录 ID;不与 from_path 同传 |
响应
200 返回裸 JSON 对象。
响应字段
| 字段 | 类型 | 必返 | 约束 | 说明 |
|---|---|---|---|---|
| created_at | string | 是 | date-time | 创建时间,RFC 3339。 |
| display_name | string | 否 | — | 服务端提供的展示名称,可能省略。 |
| file_id | string | 是 | uuid | 当前用户网盘中的稳定文件/目录 UUID;重命名不改变,复制生成新 ID。 |
| is_directory | boolean | 是 | — | 是否为目录。 |
| metadata | object<string, string> | 是 | — | 字符串键值元数据;无元数据时为 {}。 |
| mime_type | string | 是 | — | MIME 类型;目录为 application/x-directory。 |
| moderation_state | string | 否 | — | 文件审核状态;未提供时不应推断审核已通过。 |
| modified_at | string | 是 | date-time | 最后修改时间,RFC 3339。 |
| path | string | 是 | — | 当前用户可见的绝对逻辑路径。 |
| presigned_url | string | 否 | — | 临时访问 URL,可能省略;原样使用,不附带登录凭据。 |
| size | integer | 是 | int64 | 大小,单位字节;目录按服务端累计大小返回。 |
| source | string | 是 | — | 服务端记录的文件来源,不由客户端据此判断权限。 |
| storage_path | string | 否 | — | 带隔离前缀的逻辑存储路径,不是 OSS 对象 key;仅部分响应提供。 |