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": ""
}