MeBox/115doc/115开放平台/API列表/文件管理/文件(夹)更新.md

文件(夹)更新

基本信息

属性	内容
接口名称	文件(夹)更新
接口版本	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

请求示例

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-取消星标

响应示例

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

注意事项

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

修改历史

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