## 文件(夹)更新

### 基本信息

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

### 接口说明

更新文件(夹)名称或星标状态。`file_name` 与 `star` 至少传入一个。

### 接口地址

```
https://proapi.115.com/open/ufile/update
```

### 请求方式

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

### 认证方式

```
Authorization: Bearer access_token
```

### 请求参数

| 参数名      | 类型     | 必填 | 默认值 | 说明                    | 约束/示例             |
|:---------|:-------|:---|:----|:----------------------|:------------------|
| file_id   | string | 是  | -   | 需要更新的文件(夹)ID           | 3073323042143855813 |
| file_name | string | 否  | null | 新的文件(夹)名称，文件夹名称限制 255 字节 | 新的名字              |
| star      | int    | 否  | null | 是否星标：1-星标，0-取消星标       | 1                 |

### 请求示例

```shell
curl 'https://proapi.115.com/open/ufile/update' \
  -H 'Authorization: Bearer access_token' \
  --form-string 'file_id=3073323042143855813' \
  --form-string 'file_name=新的名字' \
  --form-string 'star=1'
```

### 响应字段说明

| 字段             | 类型      | 描述                |
|:---------------|:--------|:------------------|
| state          | boolean | 状态码，true 表示成功     |
| message        | string  | 错误信息              |
| code           | int     | 错误码               |
| data           | object  | 响应数据              |
| data.file_name | string  | 更新后的文件(夹)名称       |
| data.star      | int     | 更新后的星标状态：1-星标，0-取消星标 |

### 响应示例

```json
{
  "state": true,
  "message": "",
  "code": 0,
  "data": {
    "file_name": "新的名字",
    "star": 1
  }
}
```

### 注意事项

- `access_token` 由开放平台授权流程获取，并通过 `Authorization` 请求头传递。

### 修改历史

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