获取文件信息 - 接口文档 - 企业微信开发者中心

开发者中心

首页

教程

接口

社区

工具

企业内部开发

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

企业内部开发服务端API 微盘管理文件获取文件信息

获取文件信息

最后更新：2022/12/26

该接口用于获取指定文件的信息。

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

请求包体

{
    "fileid": "FILEID"
}

参数说明

参数	类型	是否必须	说明
fileid	string	是	文件fileid

权限说明

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

返回示例

{
    "errcode": 0,
    "errmsg": "ok",
    "file_info": {
        "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",
        "url": "URL"
    }
}

参数说明

参数	类型	说明
errcode	int32	错误码
errmsg	string	错误码说明
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。可用于确认是否跟与上传的文件一致，或避免重复上传相同的文件
url	string	仅微文档类型返回访问链接

删除文件

新增成员

本节内容

获取文件信息