3. 同步白名单

描述：

批量同步白名单，设备无该名单会新增，有该名单会覆盖。
注意：最大仅支持同步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 否 性别
- - nation 否 String 民族
- - idNo 是 String 人员编号（如果有证件号码需下发证件号码，没有平台可以自定义，不能重复）
- - peopleStartDate 是 String 名单有效期开始时间，例：2025-12-27 19:32:06
- - peopleEndDate 是 String 名单有效期结束时间，例：2030-03-27 19:32:06
- - idIssue 否 String 身份证签发机关
- - idAddress 否 String 身份证地址
- - icNo 否 String IC或ID卡号
- - birthday 否 String 生日，例：1997-04-03
- - timeGroupId 否 String 普通时间组ID（可设置不同的通行时间段）时间段外提示“无权限进入，请在指定时间段内识别”
- - specialGroupId 否 String 特殊时间ID
- - group 否 String 一级部门分类，例：公司
- - groupSuffix 否 String 二级部门分类，例：部门
- - passAlgo 是 boolean false：必须要带图片，true：该名单录入可以不用带图片
- - picUrl 否 String url下载图片的地址
- - featureBase64Str 否 String 人脸特征值字段可以为空,当该字段不为空时，passAlgo字段必须为true

返回参数：

参数 类型 必填 说明
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\\\":\\\"1\\\",\\\"roomNo\\\":\\\"103\\\",\\\"smallOpenId\\\":\\\"1f5sa4s8t15cs561df\\\",\\\"phoneNumber\\\":\\\"15658454200\\\",\\\"callPriority\\\":1,\\\"name\\\":\\\"1\\\",\\\"sex\\\":\\\"男\\\",\\\"nation\\\":\\\"\\\",\\\"idNo\\\":\\\"123\\\",\\\"peopleStartDate\\\":\\\"2026-11-12 00:00:00\\\",\\\"peopleEndDate\\\":\\\"2026-11-12 00:00:00\\\",\\\"idIssue\\\":\\\"\\\",\\\"idAddress\\\":\\\"\\\",\\\"icNo\\\":\\\"\\\",\\\"birthday\\\":\\\"\\\",\\\"timeGroupId\\\":\\\"\\\",\\\"specialGroupId\\\":\\\"\\\",\\\"group\\\":\\\"\\\",\\\"groupSuffix\\\":\\\"\\\",\\\"passAlgo\\\":true,\\\"picUrl\\\":\\\"\\\",\\\"featureBase64Str\\\":\\\"1\\\"}]\"}"
}

返回示例：

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