获取文件夹下的清单

获取用户云空间中指定文件夹下的文件清单。清单类型包括文件、各种在线文档（文档、电子表格、多维表格、思维笔记）、文件夹和快捷方式。该接口支持分页，但是不会递归的获取子文件夹的清单。

错误码

HTTP状态码	错误码	描述	排查建议
500	1061001	internal error.	服务内部错误，包括超时，错误码没处理。
400	1061002	params error.	请检查请求参数是否正确。
404	1061003	not found.	请确认对应资源是否存在。
403	1061004	forbidden.	请确认当前身份是否有对应上传节点的的权限，如用户是否有上传到指定doc的编辑权限。
401	1061005	auth failed.	请使用正确身份访问该接口。
404	1061007	file has been delete.	请确认对应节点未被删除。
400	1064001	page size out of limit.	请检查分页大小是否超过限制。

{ "code": 0, "data": { "files": [ { "name": "test pdf.pdf", "parent_token": "fldbcO1UuPz8VwnpPx5a9abcef", "token": "boxbc0dGSMu23m7QkC1bvabcef", "type": "file", "url": "https://bytedance.feishu.cn/file/boxbc0dGSMu23m7QkC1bvabcef" }, { "name": "test file.docx", "parent_token": "fldcnCEG903UUB4fUqfysdabcef", "shortcut_info": { "target_token": "boxcnRPaXpD4I6Je9t8k8babcef", "target_type": "file" }, "token": "nodcnVkiLQ6LD4CsUEaANrabcef", "type": "shortcut", "url": "https://bytedance.feishu.cn/file/boxcnRPaXpD4I6Je9t8k8babcef" }, { "name": "test docx", "parent_token": "fldcnCEG903UUB4fUqfysdabcef", "token": "doxcntan34DX4QoKJu7jJyabcef", "type": "docx", "url": "https://bytedance.feishu.cn/docx/doxcntan34DX4QoKJu7jJyabcef" }, { "name": "test sheet", "parent_token": "fldcnCEG903UUB4fUqfysdabcef", "token": "shtcnOko1Ad0HU48HH8KHuabcef", "type": "sheet", "url": "https://bytedance.feishu.cn/sheets/shtcnOko1Ad0HU48HH8KHuabcef" } ], "has_more": false }, "msg": "success" }

请求参数

Query 参数

page_size

string

可选

分页大小示例值：10 数据校验规则：最大值：200

page_token

string

可选

分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果示例值："MTY1NTA3MTA1OXw3MTA4NDc2MDc1NzkyOTI0Nabcef"

folder_token

string

可选

文件夹的token（若不填写该参数或填写空字符串，则默认获取用户云空间下的清单，且不支持分页）示例值："fldbcO1UuPz8VwnpPx5a9abcef"

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

application/json

Body

code

integer

必需

错误码，非 0 表示失败

data

object

必需

files

array [object {6}]

文件夹清单列表

必需

has_more

boolean

是否还有更多项

必需

msg

string

错误描述

必需

获取文件夹下的清单

错误码#

请求参数

返回响应

错误码