移动文件 - 接口文档 - 企业微信开发者中心

开发者中心

首页

教程

接口

社区

工具

企业内部开发

快速入门服务端API 客户端API 附录更新日志联系我们

企业内部开发服务端API 微盘管理文件移动文件

移动文件

最后更新：2022/12/01

该接口用于将文件移动到指定位置。

请求方式：POST（HTTPS）
请求地址: https://qyapi.weixin.qq.com/cgi-bin/wedrive/file_move?access_token=ACCESS_TOKEN

请求包体

{
    "fatherid": "FATHERID",
    "replace": true,
    "fileid": ["FILEID1", "FILEID2"]
}

参数说明

参数	类型	是否必须	说明
fatherid	string	是	当前目录的fileid,根目录时为空间spaceid
replace	bool	否	如果移动到的目标目录与需要移动的文件重名时，是否覆盖。true:重名文件覆盖 false:重名文件进行冲突重命名处理（移动后文件名格式如xxx(1).txt xxx(1).doc等）
fileid	string	是	文件fileid

权限说明

自建应用需配置到“可调用应用”列表中的应用secret所获取的accesstoken来调用（accesstoken如何获取？）
第三方应用需具有“微盘”权限
代开发自建应用需具有“微盘”权限

返回示例

{
    "errcode": 0,
    "errmsg": "ok",
    "file_list": {
        "item": [
            {
                "fileid": "FILEID",
                "file_name": "FILE_NAME",
                "spaceid": "SPACEID",
                "fatherid": "FATHERID",
                "file_size": FILE_SIZE,
                "ctime": CTIME,
                "mtime": MTIME,
                "file_type": FILE_TYPE,
                "file_status": FILE_STATUS,
                "sha": "SHA",
                "md5": "MD5"
            }
        ]
    }
}

参数说明

参数	类型	说明
errcode	int32	错误码
errmsg	string	错误码说明
file_list	obj[]	移动文件的信息列表
fileid	string	文件fileid
file_name	string	文件名字
spaceid	string	文件所在的空间spaceid
fatherid	string	文件所在的目录fileid, 在根目录时为fileid
file_size	uint64	文件大小
ctime	uint64	文件创建时间
mtime	uint64	文件最后修改时间
file_type	uint32	文件类型, 1:文件夹 2:文件 3:文档(文档) 4:文档(表格) 5:文档(收集表) 6:文档(幻灯片)
file_status	uint32	文件状态, 1:正常 2:删除
sha	string	文件sha
md5	string	文件md5

重命名文件

删除文件

本节内容

移动文件