2. 添加或更新用户

功能描述：

此命令用于管理平台向 SE3 AI 迷你机下发用户列表和用户详细信息请求URL。SE3 AI 迷你机的默认行为是创建并添加新用户，但如果用户ID已经存在，则会覆盖已有的用户信息。

为提升系统性能，管理平台一般只下发用户ID列表和获取用户详细信息的URL，SE3 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协议得内容一致，字段定义详情请看人员下发信息接口。
extend _params		dict	无	必选	扩展字段，可以为空
	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"

MQ命令示例：

使用 user_list 的形式间接下发人员信息：

// 如下是下发人员id列表的话，则人员的基础信息则通过path中的获取人员信息接口获取其他基础信息 
{
    "method": "add_users_plus", // 此关键字和内容不能变
    "userid_list": ["user_id1","user_id2"]， // 人员id列表
    "extend_params":   // 扩展字段，当前为空。用于将来的接口升级。扩展字段的内容以字典的形式填充，但扩展字段本身为必选。
    { 
        "path": "URL"// 获取用户信息的接口的URL前缀
        "notify_path": "URL" // 此处选择通过http协议返回mq命令处理结果的地址
    }  
}

使用 user_info_list 的形式直接下发人员信息：

{
    "method": "add_users_plus", // 此关键字和内容不能变

    "user_info_list":  // 人员数据列表
         [
            {
             "info":
                   {
                     "permission_ids":["1046"], //设备权限组列表
                     "name":"fubing",   //人员名称
                     "type":1     //人员类型
                   },

            "identity_id":"666",   //人员id
            "reg_url":"http://xxxx.png"  //图片地址
            },
            {
             "info":
                   {
                     "permission_ids":["1046"], //设备权限组列表
                     "name":"wuyanzu",   //人员名称
                     "type":1     //人员类型
                   },

            "identity_id":"888",   //人员id
            "reg_url":"http://xxxx.png"  //图片地址
            },

        ]，
    "extend_params":   // 扩展字段，当前为空。用于将来的接口升级。扩展字段的内容以字典的形式填充，但扩展字段本身为必选。
    { 
    }  
}

返回结果示例：

{
    "success":true，
    "code":0,
    "message":"下发人员MQ命令执行成功"
    "dev_sno":"sda23erasd" ,//设备唯一标识key
    "messageKey":"add_users_plus", //每一类消息格式的key
    "result":{
        "success_users":[
                 {"userid":"12365", "username":"小赵","message":"人员下发成功"，"code":0}
         ] ，//下发成功的人员
        "failed_users":[
                {"userid":"12366", "username":"小王","message":"无法检测到人脸", "code":"40094"},//插入失败的人员
                {"userid":"12367", "username":"小明","message":"无法检测到人脸,  "code":"40094"}
        ]
}