3. 同步白名单

描述：

批量同步白名单，设备无该名单会新增，有该名单会覆盖。

请求说明：

参数 类型 必填 说明
协议 方法 PATH
HTTPS POST /openApi/face/syncWhites

Body参数：

参数 类型 必填 说明
appId String 是 appId
expires String 是 过期时间
sign String 是 签名
deviceNo String 是 设备编号
cmd String 是 固定值：faceSyncWhites
data String 是 白名单数组字符串
- whites Array 是 白名单数组
- - userType int 是 名单类型，1：白名单，2：黑名单，3：访客
- - buildingNo String 否 幢号
- - roomNo String 否 房间号
- - smallOpenId String 否 小程序用户标识
- - phoneNumber String 否 手机号
- - callPriority int 否 呼叫优先级，0：高，1：中，2：低（呼叫房间内存在多个用户时按优先级排序后，逐个顺序呼叫）
- - name String 是 姓名
- - sex String 否 性别

返回参数：

参数 类型 必填 说明
code int 是 响应状态码
msg String 是 响应消息
appId String 是 appId
expires String 是 过期时间
sign String 是 签名
deviceNo String 是 设备编号
cmd String 是 固定值：faceSyncWhites
data String 是 空字符串，固定值：””

请求示例：

{"appId":"ym3b7f242fc0814489","expires":"1739583239","sign":"36f392b389e945b5c7ca8baa36fae53b","deviceNo":"123456789-987654321","cmd":"faceSyncWhites","data":"{\"whites\":\"[{\\\"userType\\\":1,\\\"buildingNo\\\":\\\"A1\\\",\\\"roomNo\\\":\\\"101\\\",\\\"smallOpenId\\\":\\\"\\\",\\\"phoneNumber\\\":\\\"13800000000\\\",\\\"callPriority\\\":0,\\\"name\\\":\\\"张三\\\",\\\"sex\\\":\\\"男\\\"}]\"}"}

返回示例：

{
  "code": 0,
  "msg": "操作成功",
  "appId": "ymc03e8b5544714290",
  "expires": "1767858071",
  "sign": "1d8b5f21e27a73e1e19b1487045e64ab",
  "deviceNo": "123456789-987654321",
  "cmd": "faceSyncWhites",
  "data": ""
}
作者：yrh  创建时间：2026-06-06 16:06
最后编辑：yrh  更新时间：2026-06-06 17:20