资源工坊

文件转存（文件从其他存储转存到本空间） ​

适用版本>=v7.0.2412a.20241212

接口说明：文件转存（文件从其他存储转存到本空间）

请求说明 ​

请求地址配置域名+/openapi+/v7/drives/{drive_id}/files/{parent_id}/upload_from
请求方法POST
签名方式KSO-1（配置域名+/openapi不参与签名）
权限要求查询和管理文件（用户授权） kso.file.readwrite

请求头（Header） ​

Header参数类型是否必填说明
Content-Typestring是使用：application/json
X-Kso-Datestring是RFC1123 格式的日期，例: Wed, 23 Jan 2013 06:43:08 GMT
X-Kso-Authorizationstring是KSO-1 签名值，详见《签名方法》
Authorizationstring是授权凭证，格式为：Bearer {access_token}

路径参数（Path） ​

名称类型是否必填说明
drive_idstring是驱动盘id，长度不超过1024位
parent_idstring是父文件（夹）id（根目录时为0），<= 1024 characters

请求体（Body） ​

名称类型是否必填说明
namestring是文件名,长度范围[1,240] (包含后缀,不支持"/:*?"<>|"特殊符号)
urlstring是来源文件的下载地址
sizeint64否文件大小，内部根据该字段决定是否进行文件下载后的大小校验
file_idstring否若指定则往已存在的文件上传生成新版本

请求体示例 ​

json
{
  "file_id": "string",
  "name": "string",
  "size": 0,
  "url": "string"
}

响应体（Response） ​

名称类型说明
dataobject提交文件上传完成信息返回
∟ idstring文件id
∟ drive_idstring驱动盘id
∟ parent_idstring父文件（夹）id
∟ created_byobject创建者信息
∟ ∟ avatarstring创建者头像，<= 1024 characters
∟ ∟ company_idstring创建者企业id，<= 1024 characters
∟ ∟ idstring创建者id，<= 1024 characters
∟ ∟ namestring创建者名称，<= 1024 characters
∟ ∟ typestring创建者身份类型，user：用户
∟ modified_byobject修改者信息
∟ ∟ avatarstring修改者头像，<= 1024 characters
∟ ∟ company_idstring修改者企业id，<= 1024 characters
∟ ∟ idstring修改者id，<= 1024 characters
∟ ∟ namestring修改者名称，<= 1024 characters
∟ ∟ typestring修改者身份类型，user：用户
∟ sizeint64文件大小
∟ versionint文件版本
∟ typestring文件类型
∟ namestring文件名称
∟ ctimeint64文件创建时间，时间戳，单位为秒
∟ mtimeint64文件修改时间，时间戳，单位为秒
∟ hashobject文件哈希信息
∟ ∟ sumstring哈希结果
∟ ∟ typestring哈希类型，固定为s2s
∟ ext_attrsobject[]文件扩展属性
∟ link_urlstring分享链接
∟ link_idstring分享链接id
codeint错误码
msgstring状态信息
detailstring详细信息

响应体示例 ​

json
{
    "code": 0,
    "data": {
        "id": "eyJuYW1lIjoiZG93bmxvYWQgKDEpLnBkZiIsInNpemUiOjEsImhhc2hlcyI6bnVsbCwicGFyZW50X3BhdGgiOm51bGwsIm9uX25hbWVfY29uZmxpY3QiOiJyZW5hbWUiLCJtZXRob2QiOiJQT1NUIiwiaW50ZXJuYWwiOmZhbHNlLCJmaWxlX2lkIjoiMCJ9",
        "drive_id": "2",
        "mtime": 1689213822,
        "hash": {
            "type": "s2s",
            "sum": "u3j+nr78sAFweKynRwV/3yAr7AAZsNFdaDYTA8xi414="
        }，
        "link_url": "https://10.13.80.140/path3/path4/weboffice/l/sruG5vlKAWZa",
        "link_id": "sruG5vlKAWZa",
        "parent_id": "0",
        "created_by": {
            "id": "1",
            "name": "admin",
            "avatar": "https://10.13.80.140/path3/path4/avatar/api/v1/custom_avatar/ZGVmYXVsdC9zMnMvS0hFNlFNWUZDQlRJU1NSNUVQN0JYM0dZMlJFQllHSFNOWEo2MkhSUjZSV1dIUUs1SUlEQS82ZThlZGY5MjgwLzIyMzE=",
            "company_id": "1",
            "type": "user"
        }，
        "modified_by": {
            "id": "1",
            "name": "admin",
            "avatar": "https://10.13.80.140/path3/path4/avatar/api/v1/custom_avatar/ZGVmYXVsdC9zMnMvS0hFNlFNWUZDQlRJU1NSNUVQN0JYM0dZMlJFQllHSFNOWEo2MkhSUjZSV1dIUUs1SUlEQS82ZThlZGY5MjgwLzIyMzE=",
            "company_id": "1",
            "type": "user"
        }，
        "size": 23434,
        "version": 1,
        "type": "file",
        "name": "download (3).pdf",
        "ctime": 1689213822
    }，
    "detail": "",
    "msg": "ok"
}