2. 添加或更新用户
功能描述:
此命令用于管理平台向 SE AI计算盒下发用户列表和用户详细信息请求URL。SE AI计算盒的默认行为是创建并添加新用户,但如果用户ID已经存在,则会覆盖已有的用户信息。
为提升系统性能,管理平台一般只下发用户ID列表和获取用户详细信息的URL,SE AI计算盒在收到用户列表后,会根据这两个字段组合出获取用户详细信息的实际URL。如何组合实际URL,请参见 URL组合章节。
一级参数 | 二级参数 | 类型 | 默认值 | 选择 | 说明 | 举例 |
method | string | 无 | 必选 | add_users_plus | “add_users_plus” | |
messageId | string | 空 | 可选 | MQ消息的唯一标识ID | “004a5b58-32e8-487e-a90a-2ce443877e7e” | |
userid_list | list | 无 | 必选,二选一 | 用户信息ID列表,管理平台需要保证用户ID唯一;默认行为是创建并添加新用户,但如果用户ID已经存在,则会覆盖已有的信息。 | ["user_id1","user_id2"] | |
user_info_list | list | 无 | 必选,二选一 | 用户信息列表,不只下发ID信息,还有其他基础信息,下发基础信息和通过http协议得内容一致,字段定义详情请看人员下发信息接口。 | ||
identity_id | string | 无 | 必选 | 每个用户的唯一标识id | “666” | |
reg_url | string | 无 | 可选 | 图片地址,当need_bring_pic为true时候需要带上图片数据, http://xxx, 绝对地址 | http://xxxx.jng | |
relative_pic_url | string | 无 | 可选,二选一 | 图片相对地址,相对于平台得地址,如平台地址:https://xxx.com,则图片地址可为/aaa.jpg。 | /xxx.jpg。 | |
fiqa_level | string | 无 | 可选 | 质量检测级别,共high,middle,low,custom, no 5个级别, 其中no表示下放人员不需要再进行质量检测 | ||
info | dict | 无 | 必选 | 每个用户的信息 | 请参考下面info字段 | |
import_mode | bool | false | 可选 | false:使用图片提取特征值进行注册, true:使用传入的特征值进行注册。 | ||
get_features_url | string | 无 | import_mode=true时必选,获取feature的接口url | 请参考下面下放feature_list说明 | ||
extend _params | dict | 无 | 必选 | 注意,如果为True,需要同时传入下载特征值的接口url扩展字段,可以为空 | ||
path | string | 空 | 可选 | 获取人员详细信息的URL: a. 绝对地址:必然加上协议,以http或者https开头 b. 相对地址:以"/"开始,加上接口名。如 /getUserInfo。 注意: 若人员信息通过user_info_list中下发,则此path无意义。 | “http://ip:port/getPersonInfo” | |
notify _path | string | 空 | 可选 | 管理平台URL(相对地址),用于通过http方式回传命令执行结果。相对地址的组合请参见 URL组合章节。 注意: 如果登陆时管理平台下发 uploadQueue 字段,则会通过MQ上传通道返回结果。 如果没有 uploadQueue 字段,并且 notify_path 为非空,则会向 notify_path 返回结果 如果两个字段都没有,则不会返回结果(即单向通信)。 | "http://ip:port:/getResult" |
info中字段信息如下:
二级参数 | 三级参数 | 类型 | 默认值 | 选择 | |
info | |||||
name | string | 无 | 必选 | 用户名称 | |
type | string | 无 | 必选 | 1:员工 2: 访客 3: 黑名单 4:陌生人 5:VIP | |
permission_ids | list | 无 | 必选 | 权限组id列表 |
MQ命令示例:
使用 user_list 的形式间接下发人员信息:
使用 user_info_list 的形式直接下发人员信息:
下放feature_list的接口请求参数及返回:
返回结果示例:
Last updated