## 新建文件夹

### 基本信息

| 属性         | 内容                               |
|:-----------|:---------------------------------|
| 接口名称       | 新建文件夹                            |
| 接口版本       | v1.0                             |
| 接口路径       | /add                             |
| 请求方法       | POST                             |
| 接口状态       | 生产环境                             |

### 接口说明

在指定父目录下新建文件夹。

### 接口地址

```
https://proapi.115.com/open/folder/add
```

### 请求方式

```
POST
Content-Type: multipart/form-data
```

### 认证方式

```
Authorization: Bearer access_token
```

### 请求参数

| 参数名      | 类型     | 必填 | 默认值 | 说明                         | 约束/示例               |
|:---------|:-------|:---|:----|:---------------------------|:--------------------|
| pid      | string | 否  | "0" | 父目录ID，根目录ID为 `0`           | 3073323042143855813 |
| file_name | string | 是  | -   | 文件夹名称，最多255个字符             | 新建文件夹名称             |

### 请求示例

```shell
curl 'https://proapi.115.com/open/folder/add' \
  -H 'Authorization: Bearer access_token' \
  --form-string 'pid=3073323042143855813' \
  --form-string 'file_name=新建文件夹名称'
```

### 响应字段说明

| 字段             | 类型      | 描述                    |
|:---------------|:--------|:----------------------|
| state          | boolean | 接口状态，true表示成功        |
| message        | string  | 异常信息                  |
| code           | int     | 异常码                   |
| data           | object  | 响应数据                  |
| data.file_name | string  | 新建的文件夹名称              |
| data.file_id   | string  | 新建的文件夹ID              |

### 响应示例

```json
{
  "state": true,
  "message": "",
  "code": 0,
  "data": {
    "file_name": "",
    "file_id": ""
  }
}
```

### 注意事项

- `pid` 不传或传 `0` 时在根目录下新建文件夹。
- `user_id` 由服务端根据 access token 获取，无需传入。

### 修改历史

| 修改时间                         | 修改说明 |
|:-----------------------------|:-----|
| 2025年04月01日(周二) 00:00:00 | 创建文档 |