重命名资源
1.接口描述
接口说明:重命名资源(仅限于用户上传的图片、视频及 PDF 等媒体文件)。
请求方式:
- 固件版本 V2.6.0 及以上:POST [ip]/mwapi/V2.0/source/rename-source
- 固件版本 V2.5.0 及以下:POST [ip]/mwapi/rename-source
管理员权限 | 登录认证 |
---|---|
否 | 是 |
2.输入参数
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
id | 是 | Int | 资源ID,可通过获取资源列表获得。 |
name | 是 | String | 新名称 |
3.输出参数
参数名称 | 类型 | 描述 |
---|---|---|
status | Int | 状态码 |
message | String | 状态描述 |
4.示例
将ID为2039的资源文件命名为“New Source Name”。
输入示例
{
"id":2039,
"name":"New Source Name"
}
输出示例
{
"message": "success",
"status": 0
}
5.错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
错误码 | 定义 | 说明 |
---|---|---|
7 | MW_STATUS_INVALID_ARG | 参数缺失 |
39 | MW_STATUS_MISMATCH | 资源不存在 |