说明

在设备屏幕上显示预约人用户名,并永久存储到设备内部。

  • 用户名长度不超过18个字符.
  • 含有非英文字符,则只显示前6个字符
  • 屏幕复位时,会从存储中读取预约人名称并显示

    接口地址

    POST /api/ac/screen-set-user?appid={APPID}

请求参数说明

名称 类型 必填 说明
appid string Y 管理员给用户创建的应用ID

Body 示例

 {
  "gwsn": "dcda0ccdcc3e",
  "text": "张三",
  "manual_clear":false
 }

字段说明

名称 类型 必填 说明
gwsn string Y 网关序列号
text string(18) Y 用户名。长度最大18个字符:中文只显示前6个,全英文(含空格)显示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