---
title: 获取文件列表
description: GET /nd/api/file/list_dir：获取文件列表 接口说明，包含路径、方法、参数和返回信息。
slug: api-get-nd-api-file-list-dir
lang: zh
category: 文件 API
category_order: 8
order: 104
api_method: GET
api_path: /nd/api/file/list_dir
api_label: 获取文件列表
keywords:
  - API
  - 获取文件列表
  - /nd/api/file/list_dir
---

# 获取文件列表

| 属性 | 值 |
| --- | --- |
| HTTP 方法 | `GET` |
| 接口路径 | `/nd/api/file/list_dir` |
| 所属分类 | 文件 API |

## 接口说明

接口路径：`/nd/api/file/list_dir`

HTTP 方法：`GET`


**HTTP 方法：** `GET`

#### URL 参数

参数名 Comment(说明)
parent_id 父文件夹 id（必填） string 当 parent 为 1 时返回企业文件夹内容，2 返回个人文件夹内容，3 返回我的
项目，4 返回我加入的分享，其它 fileId 返回正常的文件夹中的内容。
page_size 页的大小 number
page 页号 number
type 类型：分为 1 - file，2 - folder，0 - all 三种类型 string
#### 返回字段说明

属性名 类型 说明
files 数组 文件信息 {fileId, name, …}
total int 总数量
page int 页容量
success boolean 获取成功标记
code int 返回错误码 0 表示成功

## 调用说明

- 调用前需完成 [获取 token](api-post-api-token-do.md) 或相应免登录认证，并在请求 Header 中携带 `Authorization: Bearer <access_token>`。
- 参数和返回字段如因部署版本存在差异，应以实际私有云 API 文档和联调结果为准。
- 所属分类：文件 API。