第三方应用开发
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
小程序接入对外收款
第三方应用开发
服务端API
微盘
管理文件
获取文件列表
获取文件列表
最后更新:2024/07/18

该接口用于获取指定地址下的文件列表。

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

请求包体

{
    "spaceid": "SPACEID",
    "fatherid": "FATHERID",
    "sort_type": 1,
    "start": 0,
    "limit": 100
}

参数说明

参数类型是否必须说明
spaceidstring空间spaceid
fatheridstring当前目录的fileid,根目录时为空间spaceid
sort_typeuint32列表排序方式 1:名字升序;2:名字降序;3:大小升序;4:大小降序;5:修改时间升序;6:修改时间降序
startuint32首次填0, 后续填上一次请求返回的next_start
limituint32分批拉取最大文件数, 不超过1000

权限说明

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

返回示例

{
    "errcode": 0,
    "errmsg": "ok",
    "has_more": true,
    "next_start": 1,
    "file_list": {
        "item": [
            {
                "fileid": "FILEID1",
                "file_name": "FILE_NAME1",
                "spaceid": "SPACEID",
                "fatherid": "FATHERID",
                "file_size": 1024,
                "ctime": 177777777,
                "mtime": 277777777,
                "file_type": 2,
                "file_status": 1,
                "sha": "SHA",
                "md5": "MD5",
                "url": "URL"
            }
        ]
    }
}

参数说明

参数类型说明
errcodeint32错误码
errmsgstring错误码说明
has_morebooltrue为列表还有内容, 需要继续分批拉取
next_startuint32下次分批拉取对应的请求参数start值
file_listobj[]文件列表
fileidstring文件fileid
file_namestring文件名字
spaceidstring文件所在的空间spaceid
fatheridstring文件所在的目录fileid, 在根目录时为fileid
file_sizeuint64文件大小
ctimeuint64文件创建时间
mtimeuint64文件最后修改时间
file_typeuint32文件类型, 1:文件夹 2:文件 3:微文档(文档) 4:微文档(表格) 5:微文档(收集表)
file_statusuint32文件状态, 1:正常 2:删除
shastring文件sha
md5string文件md5
urlstring仅微文档类型返回访问链接
上一篇获取空间信息
下一篇上传文件
    本节内容
服务端API
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
小程序接入对外收款
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们