重命名资源
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 | 资源不存在 |