说明
在设备屏幕上显示设备名称,并永久存储到设备内部。
- 设备名称长度不超过18个字符
- 同时会更新缓存和数据库中的设备名称
- 屏幕复位时,会从存储中读取设备名称并显示
接口地址
POST /api/ac/screen-set-device?appid={APPID}
请求参数说明
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| appid | string | Y | 管理员给用户创建的应用ID |
Body 示例
{
"gwsn": "dcda0ccdcc3e",
"text": "办公室插座",
"manual_clear":false
}字段说明
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| gwsn | string | Y | 网关序列号 |
| text | string | Y | 设备名称,长度不超过18个字符 |
| manual_clear | bool | N | 手动删除屏幕显示的设备名称,默认是false。true:需要用户自动调用【删除屏幕设备名称】接口。平台不做处理,false:平台先清除屏幕设备名称,再保存屏幕设备名称。 |
回复数据
{
"code": 200,
"unikey": "5cb177d2-5527-4cd7-b906-300237e17e19",
"msg": "成功"
}回复字段说明
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | int | Y | 200:成功,其它:异常。参考文档 通用返回值 |
| unikey | string | Y | 平台生成的唯一指令id |
| msg | string | Y | 消息说明 |
作者:阮德明 创建时间:2026-05-26 14:59
最后编辑:阮德明 更新时间:2026-07-13 09:41
最后编辑:阮德明 更新时间:2026-07-13 09:41