Skip to content

提交文件上传完成

适用版本>=v7.0.2307b.2023720

接口说明:提交文件上传完成

请求说明

请求地址配置域名+/graph+/v7/drives/{drive_id}/files/{parent_id}/commit_upload
请求方法POST
签名方式WPS-4签名/WPS-4-GM签名(配置域名+/graph不参与签名)
权限要求以用户身份管理文档(用户授权) kso.drive.as_user.manage 更新文件(用户授权) kso.file.write 应用管理文件(应用授权) kso.appdrive.file.write

请求头(Header)

名称是否必填说明
Content-Type固定为: application/json
Wps-Docs-Date取当前时间, 示例: Wed, 23 Jan 2013 06:43:08 GMT
Wps-Docs-Authorization计算方法参考签名说明
Authorization授权凭证,格式为: Bearer {access_token}

路径参数(Path)

名称参数类型是否必填说明
drive_idstring驱动盘id,<= 1024 characters
parent_idstring父文件(夹)id(根目录时为0),<= 1024 characters

请求体(Body)

名称类型是否必填说明
idstring上传标识,从请求文件上传信息响应中取到的id,<= 1024 characters
store_responseobject[]存储回传信息,根据请求文件上传信息响应中的store_response_keys字段从上传实体文件响应中获取,<= 1024 items

请求体示例

{
    "id":"eyJuYW1lIjoiZG93bmxvYWQgKDEpLnBkZiIsInNpemUiOjEsImhhc2hlcyI6bnVsbCwicGFyZW50X3BhdGgiOm51bGwsIm9uX25hbWVfY29uZmxpY3QiOiJyZW5hbWUiLCJtZXRob2QiOiJQT1NUIiwiaW50ZXJuYWwiOmZhbHNlLCJmaWxlX2lkIjoiMCJ9",
    "store_response":[
        {
            "name":"X-Wps3-Info-Token",
            "value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJiIjoid3BzZmlsZSIsImUiOiJmOTUxNjVkYmNjOGYyOWEwZGZlOTY3NmIxNDAwYjcxYSIsImgiOiJzaGEyNTYiLCJoMSI6IjdiMGE4ZjM1Y2VlOThkOTYwMTJjZTgxNzcxM2U0ZmEwNjMyZDkxYzk4MTRiMjg1NTA4NmI3MTA4YjBmNDQxMTkiLCJrIjoieXVuZG9jL2Y2Y2RFUnpuNFVCb1ZtMW1KWklybnR2dFVTMjE5MTk1OTA3NTM4OTQ0MCIsImwiOiJ1cy1lYXN0LTEiLCJwIjowLCJzIjoyMzQzNCwidCI6MTY4OTIxMzgwNywidSI6IiIsInUxIjoiYjE5ZTAxMTRjNThlYWI4YzI4OWMifQ.4xe35xYZMRWVFDDTcVKlx_5ke2uEv-pdqnrF0NlxShk"
        }
    ]
}

响应体(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[]文件扩展属性
permissionobject文件权限
link_urlstring分享链接
link_idstring分享链接id
codeinteger错误码,参照《错误码说明》
msgstring状态信息
detailstring详细信息

响应体示例

{
    "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"
}