重命名画面
1.接口描述
接口说明:重命名画面。
请求方式:
- 固件版本 V2.6.0 及以上:POST [ip]/mwapi/V2.0/scene/rename-scene
- 固件版本 V2.5.0 及以下:POST [ip]/mwapi/rename-scene
| 管理员权限 | 登录认证 |
|---|---|
| 否 | 是 |
2.输入参数
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| sceneId | 是 | Int | 画面 ID,可通过获取画面列表获得 |
| name | 是 | String | 新的画面名称 |
| showId | 否 | Int | 演示稿ID,可通过获取演示稿列表获得 |
3.输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| message | String | 状态描述 |
4.示例
将演示稿7中的画面100更名为“New Name”。
输入示例
{
"sceneId":100,
"name":"New Name",
"showId":7
}
输出示例
{
"message": "success",
"status": 0
}
5.错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
| 错误码 | 定义 | 说明 |
|---|---|---|
| 7 | MW_STATUS_INVALID_ARG | 参数缺失 |
| 39 | MW_STATUS_MISMATCH | 画面不存在 |
| 48 | MW_STATUS_INFO_CHANGED | 禁止操作非当前演示稿内容 |