重命名文件 - 接口文档 - 企业微信开发者中心

开发者中心

首页

教程

接口

社区

工具

企业内部开发

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

企业内部开发服务端API 微盘管理文件重命名文件

重命名文件

最后更新：2022/12/01

该接口用于对指定文件进行重命名。

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

请求包体

{
    "fileid": "FILEID",
    "new_name": "NEW_NAME"
}

参数说明

参数	类型	是否必须	说明
fileid	string	是	文件fileid
new_name	string	是	重命名后的文件名（注意：文件名最多填255个字符, 英文算1个, 汉字算2个）

权限说明

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

返回示例

{
    "errcode": 0,
    "errmsg": "ok",
    "file": {
        "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	错误码说明
fileid	string	文件fileid
file_name	string	文件名字
spaceid	string	文件所在的空间spaceid
fatherid	string	文件所在的目录fileid, 在根目录时为spaceid
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

新建文件夹/文档

移动文件

本节内容

重命名文件