登录
设备收到访客增量同步的指令后主动调用该接口。
请求包体：
{
"cmd":"get_visitor_by_ids",
"headers":
{
"req_id":"xxxxx"
},
"body":
{
"userids":
[
"x1","x2","x3"
],
"is_req_public_key":1
}
}参数说明：
| 参数名 | 是否必须 | 类型 | 描述 |
|---|---|---|---|
| req_id | 是 | string | 请求的id，自行保证不会重复即可 |
| userids | 是 | array(string) | 访客id列表，最多200人 |
| is_req_public_key | 否 | Uint32 | 默认0, 0:不返回, 1:才返回 |
返回结果：
{
"headers":
{
"req_id" : "xxxx"
},
"body":
{
"userinfo":
[
{
"userid":"x1",
"openvid":123456,
"user_type":1,
"public_key": "AmOVOOcprQJXEi94HPv9S",
"pass_rule_list": [
{
"id":0,
"rule":"9:00-10:00 * * 1-5 *",
"effect_time":1542874137
},
{
"id":1,
"rule":"9:300-10:00 * * 6 *",
"effect_time":1542874137
}
],
"name":"张三",
"fa_list":[
{
"id":0,
"data":"xxxx"
},
{
"id":1,
"data":"xxxx"
}
]
},
{
"userid":"x2",
"openvid":1234567,
"user_type":1,
"public_key": "AmOVOOcprQJXEi94HPv9S",
"pass_rule_list": [
{
"id":0,
"rule":"9:00-10:00 * * 1-5 *",
"effect_time":1542874137
},
{
"id":1,
"rule":"9:300-10:00 * * 6 *",
"effect_time":1542874137
}
],
"fa_list":[
{
"id":0,
"data":"xxxx"
},
{
"id":1,
"data":"xxxx"
}
],
"name":"李四"
},
{
"userid":"x3",
"openvid":12345678,
"name":"王五",
"user_type":1,
"public_key": "AmOVOOcprQJXEi94HPv9S",
"pass_rule_list": [
{
"id":0,
"rule":"9:00-10:00 * * 1-5 *",
"effect_time":1542874137
},
{
"id":1,
"rule":"9:300-10:00 * * 6 *",
"effect_time":1542874137
}
],
"fa_list":[
{
"id":0,
"data":"xxxx"
},
{
"id":1,
"data":"xxxx"
}
]
}
]
},
"errcode": 0,
"errmsg": "ok"
}参数说明：
| 参数名 | 描述 |
|---|---|
| req_id | 透传请求的req_id |
| errcode | 错误码 |
| errmsg | 错误码描述 |
| userid | 成员id(字符串)，长度为1-64个字节 |
| openvid | 成员id(uint64) ， 可用于二维码签名校验 |
| user_type | 成员的类型： 0：企业员工 1：访客 本接口固定均为1 |
| public_key | 离线二维码签名校验的公钥 |
| pass_rule_list | 放行规则列表，id为编号，rule为具体规则，其解析语法请参考附录门禁放行规则语法说明 |
| effect_time | 规则生效时间 |
| fa_list | 成员脸部识别信息(base64),id,data数据同上传用户数据 |
| name | 成员姓名 |
注：成员没有放行规则或者放行规则为空时，建议默认行为是员工通行，访客不可通行。
