Skip to content

复制文件

适用版本>=v7.0.2512.20251225

接口说明:复制文件

请求说明

请求地址配置域名+/openapi+/v7/appfiles/drives/{drive_id}/files/{file_id}/copy
请求方法POST
签名方式KSO-1(配置域名+/openapi不参与签名)
权限要求应用身份管理文档(应用授权) kso.appfiles.readwrite

请求头(Header)

Header参数类型是否必填说明
X-Kso-DatestringRFC1123 格式的日期,例: Wed, 23 Jan 2013 06:43:08 GMT
X-Kso-AuthorizationstringKSO-1 签名值,详见《签名方法》
Authorizationstring授权凭证,格式为:Bearer {access_token}

路径参数(Path)

名称类型是否必填说明
drive_idstring驱动盘id
file_idstring文件id

查询参数(Query)

名称类型是否必填说明
_w_third_user_idstring操作者id

请求体(Body)

字段名类型必填说明
dst_drive_idint64目标盘ID
dst_parent_idstring目标父目录ID
file_namestring文件名称

请求体示例

json
{
  "dst_drive_id": 1234567890,
  "dst_parent_id": "0",
  "file_name": "复制后的文件名称.txt"
}

响应体(Response)

名称类型说明
dataobject返回的数据对象
idstring文件 ID
drive_idstring驱动盘 ID
parent_idstring父目录 ID(示例:"0")
created_byobject创建者信息
∟∟ idstring身份 ID
∟∟ typestringEnum: "sp"
modified_byobject修改者信息
∟∟ idstring身份 ID
∟∟ typestringEnum: "sp"
sizeinteger文件大小(字节)
versioninteger文件版本号
typestring文件类型 Enum: "folder","file"
namestring文件名称
ctimeinteger创建时间
mtimeinteger修改时间
sharedboolean是否开启分享(应用文档:false)
link_urlstring链接 URL(应用文档:为空字符串)
link_idstring链接 ID(应用文档:为空字符串)
codeint错误码
msgstring状态信息
detailstring详细信息

响应体示例

json
{
    "data": {
        "id": "350745587089408",
        "drive_id": "349087249465344",
        "parent_id": "0",
        "created_by": {
            "id": "userId",
            "type": "sp"
        },
        "modified_by": {
            "id": "userId",
            "type": "sp"
        },
        "size": 14498,
        "version": 1,
        "type": "file",
        "name": "附件拷贝.otl",
        "ctime": 1764928529,
        "mtime": 1764928529,
        "shared": false,
        "link_url": "",
        "link_id": ""
    },
    "code": 0,
    "detail": "",
    "msg": "ok"
}