3. 删除用户

功能描述:

删除一个或多个用户。

如果删除列表中的某个用户ID不存在,则会跳过删除此用户,继续执行其它用户的删除。

参数描述(JSON格式):

一级参数二级参数类型默认值选择说明举例

method

string

必选

delete_users

“delete_users”

messageId

string

可选

MQ消息的唯一标识ID

“004a5b58-32e8-487e-a90a-2ce443877e7e”

userid_list

list

必选

用户id列表

["user_id1","user_id2"]

extend_params

dict

可选

扩展字段

notify_path

string

必选

管理平台URL(相对地址),用于通过http方式回传命令执行结果。 相对地址的组合请参见 URL组合章节。 注意: 如果登陆时管理平台下发 uploadQueue 字段,则会通过MQ上传通道返回结果。 如果没有 uploadQueue 字段,并且 notify_path 为非空,则会向 notify_path 返回结果 如果两个字段都没有,则不会返回结果(即单向通信)。

"http://ip:port:/getResult"

MQ命令示例:

{
    "method": "delete_users", //此关键字和内容不能变
    "userid_list": ["user_id1","user_id2"], //用户id列表
    "extend_params": {
        "notify_path": "URL" // 返回mq命令处理结果的地址
    }  //扩展字段,里面内容可以为空,但字段为必选
}

返回结果示例:

{
    "success":true
    "code":0,
    "message":"删除人员MQ命令执行成功"
    "dev_sno":"dasdas23123" ,//设备唯一标识key
    "messageKey":"delete_users" ,//每一类消息格式的key
    "result":{
        "success_users":[
                 {"userid":"12365", "message":"人员删除成功","code":0},
                 {"userid":"12366", "message":"人员删除成功","code":0}
         ] ,                                                                        
        "failed_users":[
                {"userid":"12367", "message":"人员删除失败" , "code":40095}
        ]

    }
}

Last updated