企业自建应用开发
基础
连接微信
办公
文档
接收外部数据到智能表格
会议
会议统计管理
企业自建应用开发
服务端API
企业数据存档
微盘内容存档
获取文件列表
获取文件列表
最后更新:2026/07/20

可通过此接口获取开启微盘内容存档成员所授权的空间内所上传或继承的文件列表,包含文件名、类型、创建者、大小等。

请求方式: POST(HTTPS
请求地址: https://qyapi.weixin.qq.com/cgi-bin/security/wedrive/get_auth_file_list?access_token=ACCESS_TOKEN

请求包体

{
    "userid": "woxxxxxxxxx",
    "is_resigned": 0,
    "spaceid": "spxxxxxxxxx",
    "cursor": "JMgigeong",
    "limit": 2
}

参数说明:

参数是否必须类型说明
access_tokenString调用接口凭证
useridString成员userid
is_resignedInterger查询已离职或在职的userid,默认查询在职。0:在职 1:已离职
spaceidString空间ID
cursorString上一次调用时返回的next_cursor,第一次拉取可以不填
limitInterger本次查询返回的最大条数。不超过100,默认100条

 

权限说明:
调用的应用需要满足如下的权限:

应用类型权限要求
自建应用配置到「文件内容存档 - 可调用接口的应用」中
代开发应用暂不支持
第三方应用暂不支持

返回结果:

{
    "errcode": 0,
    "errmsg": "ok",
    "file_list": [
        {
            "fileid": "spxxxx",
            "file_name": "文件名",
			"path":"文件夹/文件名",
            "creator": {
                "userid": "文件创建userid"
            },
            "file_size": 1024,
            "file_type": 1,
            "doc_url": "在线文档url"
        }
    ],
    "next_cursor": "xjigeojgeigwj",
    "has_more": true
}

参数说明:

参数类型说明
errcodeInteger错误码
errmsgString错误码说明
file_listObject数据文件列表信息,详见FileInfo
next_cursorString下一次查询时使用,将值填到请求包的cursor字段中
has_moreInteger是否还有更多未拉取的数据,1:是;0:否

FileInfo

参数类型说明
fileidString文件ID
file_nameString文件名
pathString文件的绝对路径(不包括空间节点)。当满足以下两个条件时,该字段会返回:
1. 文件所在的空间超管在存档人员范围内
2. 空间在超管的授权存档范围内
creatorObject文件创建者信息
creator.useridString文件创建者userid
file_sizeInterger文件大小
file_typeInterger文件类型。1:在线文档 2:普通文件
doc_urlString在线文档url。当file_type1时返回
上一篇获取成员授权空间
下一篇下载文件
    本节内容
服务端API
基础
连接微信
办公
文档
接收外部数据到智能表格
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
JS-SDK
基础
连接微信
办公
消息推送(原“群机器人”)
更新日志