一、指令概述
该指令用于调用钉钉开放平台 API，获取指定钉盘空间、指定父目录下的所有文件与子文件夹列表，支持分页查询，返回结构化 JSON 数据，适用于钉盘文件遍历、批量下载、目录同步、文件监控等自动化场景。
可查看官方文档： https://open.dingtalk.com/document/development/get-a-list-of-files-or-folders
二、核心参数配置
| 参数名称 | 说明 | 输入格式 / 规则 |
| 凭证 | 钉钉开放平台接口调用凭证（access_token） | 必填；通过「获取开发平台凭证」指令获取 |
| 用户 Id | 操作人的钉钉用户 ID | 必填；为一串数字，可通过「查询用户 Id」指令或钉钉管理后台 - 通讯录获取 |
| space_id | 钉盘空间 ID | 必填；通过「获取空间列表」指令获取，用于指定要访问的钉盘空间 |
| 父目录 Id | 目标目录 ID | 必填；0代表用户空间根目录，填写具体 ID 则查询对应子目录 |
| next_token | 分页查询标识 | 选填；首次查询留空；分页查询时，传入上一轮接口返回的next_token，获取下一页数据 |
| 生成变量【获取文件或者文件夹列表】 | 存储查询结果的输出变量 | 必填；返回字典格式，包含文件 / 文件夹明细列表、分页标识等信息 |
三、典型操作示例
示例：查询钉钉钉盘根目录文件列表
· 凭证：ding_access_token_xxxx
· 用户 Id：m4Pxxxxxxxxxx
· space_id：xxxxxxxx
· 父目录 Id：0
· next_token：（留空）
· 输出变量：ding_file_list
· 执行效果：返回该钉盘空间根目录下所有文件、文件夹的完整信息
输出结果：
四、注意事项
1. 权限校验：操作人必须拥有目标钉盘空间、目录的查看权限，否则返回无权限报错；
2. 分页逻辑：钉盘接口单次返回数据有限，文件较多时需通过next_token循环分页；
3. 数据区分：通过type字段区分文件（FILE）与文件夹（FOLDER），可用于递归遍历子目录；
权限：这俩个权限记得要开