# 获取文件夹中的文件清单
- 该接口用于获取用户云空间指定文件夹中文件信息清单。文件的信息包括名称、类型、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 |
orderBy | string | 否 | 排序字段 默认值:CreatedTime 可选值: EditedTime CreatedTime name |
direction | string | 否 | 排序方向 默认值:DESC 可选值: ASC DESC |
# 响应
# 响应体
# 响应体
名称 | 类型 | 描述 |
---|---|---|
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 |