获取文件夹中的文件清单

• 该接口用于获取用户云空间指定文件夹中文件信息清单。文件的信息包括名称、类型、visitCode、创建时间、所有者ID、安全等级等。

使用限制

本接口仅支持获取当前层级的文件信息，不支持递归获取子文件夹中的文件信息清单。S4级别的资源会被过滤掉。

请求

基本
HTTP URL	https://hi-gw.weizhipin.com/open-apis/zhishu/resource/folder/files
HTTP Method	GET
支持的应用类型	自建应用
权限要求 开启任一权限即可	资源基本信息查询

请求头

名称	类型	必填	描述
Authorization	string	是	user_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560"
Content-Type	string	是	固定值："application/json; charset=utf-8"

查询参数

名称	类型	必填	描述
pageSize	int	否	分页大小 示例值：10 默认值：50 数据校验规则：最大值：200
pageToken	string	否	分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 pageToken，下次遍历可采用该 page_token 获取查询结果 示例值："1565676577122621"
visitCode	string	是	要获取的文件夹的visitCode

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
message	string	错误描述
zpData	object
--files	array
---- visitCode	string	文件的visitCode
---- name	string	文件的标题
---- type	string	文件类型
---- fileType	string	类型(file /folder)
---- url	string	文件的访问地址
---- securityLevel	string	文件的安全等级
---- createOpenId	string	创建者的openId
---- createTime	string	创建时间
---- latestModifyTime	string	最近一次修改时间
-- hasMore	bool	是否还有更多项
-- pageToken	string	下一页的pageToken

响应示例

{
  "code": 0,
  "zpData": {
    "data": [
      {
        "visitCode": "SVvmW17Sgq6",
        "type": "folder",
        "name": "测试22",
        "createOpenId": "ou_9870ac50b7fa625cd02c7442da3675e2",
        "createTime": 1648118998000,
        "latestModifyTime": 1721744833000,
        "url": "https://zhishu-qa.weizhipin.com/folder/SVvmW17Sgq6",
        "securityLevel": "S3"
      },
      {
        "visitCode": "J51Hr2be0b",
        "type": "bs",
        "name": "未命名文件.xlsx",
        "createOpenId": "ou_9870ac50b7fa625cd02c7442da3675e2",
        "createTime": 1648693686000,
        "latestModifyTime": 1681092260000,
        "url": "https://zhishu-qa.weizhipin.com/bs/J51Hr2be0b",
        "securityLevel": "S3"
      },
      {
        "visitCode": "oda9NthGdSM",
        "type": "folder",
        "name": "x",
        "createOpenId": "ou_9870ac50b7fa625cd02c7442da3675e2",
        "createTime": 1648698748000,
        "latestModifyTime": 1699866364000,
        "url": "https://zhishu-qa.weizhipin.com/folder/oda9NthGdSM",
        "securityLevel": "S3"
      },
      {
        "visitCode": "MVBr2gCp1q",
        "type": "bs",
        "name": "未命名文件.doc",
        "createOpenId": "ou_9870ac50b7fa625cd02c7442da3675e2",
        "createTime": 1648818123000,
        "latestModifyTime": 1681092260000,
        "url": "https://zhishu-qa.weizhipin.com/file/MVBr2gCp1q",
        "securityLevel": "S2"
      },
      {
        "visitCode": "bDLLUV9LRJn",
        "type": "folder",
        "name": "团队空间-杭州产研中心",
        "createOpenId": "ou_9870ac50b7fa625cd02c7442da3675e2",
        "createTime": 1648887214000,
        "latestModifyTime": 1681092260000,
        "url": "https://zhishu-qa.weizhipin.com/folder/bDLLUV9LRJn",
        "securityLevel": "S3"
      },
      {
        "visitCode": "pUxWxLBJRY",
        "type": "bs",
        "name": "未命名文件_20220402163602.doc",
        "createOpenId": "ou_9870ac50b7fa625cd02c7442da3675e2",
        "createTime": 1648888562000,
        "latestModifyTime": 1681092260000,
        "url": "https://zhishu-qa.weizhipin.com/file/pUxWxLBJRY",
        "securityLevel": "S3"
      },
      {
        "visitCode": "ICT4cGgIph",
        "type": "file",
        "name": "20200630234940623.png",
        "createOpenId": "ou_9870ac50b7fa625cd02c7442da3675e2",
        "createTime": 1649758045000,
        "latestModifyTime": 1681092260000,
        "url": "https://zhishu-qa.weizhipin.com/file/ICT4cGgIph",
        "securityLevel": "S2"
      },
      {
        "visitCode": "UeZmhrdNoO",
        "type": "bs",
        "name": "未命名文件_20220412182902.doc",
        "createOpenId": "ou_9870ac50b7fa625cd02c7442da3675e2",
        "createTime": 1649759342000,
        "latestModifyTime": 1681092260000,
        "url": "https://zhishu-qa.weizhipin.com/file/UeZmhrdNoO",
        "securityLevel": "S3"
      },
      {
        "visitCode": "LIATsCfIm4",
        "type": "bs",
        "name": "Result_kuaidi.iql_04081724.xlsx",
        "createOpenId": "ou_9870ac50b7fa625cd02c7442da3675e2",
        "createTime": 1649763742000,
        "latestModifyTime": 1681092260000,
        "url": "https://zhishu-qa.weizhipin.com/bs/LIATsCfIm4",
        "securityLevel": "S2"
      },
      {
        "visitCode": "0Zh0JpoJgL",
        "type": "bs",
        "name": "未命名文件_20220412205548.doc",
        "createOpenId": "ou_9870ac50b7fa625cd02c7442da3675e2",
        "createTime": 1649768148000,
        "latestModifyTime": 1681092260000,
        "url": "https://zhishu-qa.weizhipin.com/file/0Zh0JpoJgL",
        "securityLevel": "S3"
      },
      {
        "visitCode": "U9twSueWCg",
        "type": "bs",
        "name": "未命名文件.xlsx",
        "createOpenId": "ou_9870ac50b7fa625cd02c7442da3675e2",
        "createTime": 1649771498000,
        "latestModifyTime": 1681092260000,
        "url": "https://zhishu-qa.weizhipin.com/bs/U9twSueWCg",
        "securityLevel": "S3"
      }
    ],
    "hasMore": true,
    "pageToken": "h4FZ7uMqnKnrCbIOtK3VbA=="
  },
  "success": true
}