FastGPT第三方API数据集获取文件树的操作方法

结论

本接口用于获取FastGPT第三方API数据集的文件树，通过合法的POST请求即可获取指定目录下的文件与文件夹列表。响应结果包含文件或文件夹的详细元数据信息。

具体怎么做

1. 构造POST请求，请求地址为{{baseURL}}/v1/file/list。
2. 设置请求头：
   • Authorization: Bearer {{authorization}}
   • Content-Type: application/json
3. 配置请求体参数（均为可选）：
   • parentId：父级id，不传或传null时，使用配置的basePath作为根目录
   • searchKey：检索词，用于过滤目录内容

请求体默认示例为{"parentId": null, "searchKey": ""}。 响应为标准JSON格式，包含success、message和data字段，data数组内为文件/文件夹元数据。

注意事项

1. 未传入parentId或传入null时，接口默认以配置的basePath作为根目录。
2. 请求头的Authorization必须携带Bearer前缀，格式错误会导致认证失败。
3. searchKey为空字符串时，接口返回全量目录内容，不进行检索过滤。
4. 响应的data数组元素包含id、parentId、type、name、updateTime、createTime和hasChild共7个字段。

来源：FastGPT 官方文档