# 异步批量更新用户 -------------------------------------------------------- 接受用户信息,异步同步到WeLink通讯录,支持批量修改用户部分信息,每次请求最多支持**100个**用户。 > 此接口为异步接口,返回的信息仅表明参数是否合法,是否修改成功请访问[查询用户异步同步结果](staff_query_internal.md)接口查询 。 ## 请求格式说明 ** 调试工具:** 在线调试

请求方式:PUT (HTTPS)

请求地址:

https://open.welink.huaweicloud.com/api/contact/v1/users/update

认证方式: access_token,请参考获取access_token

请求头部:

Accept-Charset:UTF-8
Content-Type:application/json
x-wlk-Authorization:access_token

请求参数:

{
     "personInfo": [
        {
            "corpUserId": "111",
            "userNameCn" : "张三改",
            "userNameEn": "zhangsan01"
        }
    ]
}

请求参数说明:

参数 参数类型 必填 说明
corpUserId String 该用户在租户自身系统的登录标识,用于认证和邮箱登录(客户内唯一)
userNameCn String 人员中文名称
userNameEn String 人员英文名称
sex String 性别。仅:M/F, M: 男, F: 女
corpDeptCode String 客户侧部门唯一编码,请先完成部门信息同步,否则传递该字段,系统无法识别该用户的部门
userEmail String 邮箱
landlineNumber String 座机
addressCode String 邮政编码
corpSecretary String 秘书。在导入用户时,如果秘书帐号还不存在,需要先维护秘书用户信息,再重新同步
isOpenAccount String “1”:表示开户,“0”:表示仅同步不开户
address String 办公位置信息
remark String 备注信息
isHideMobileNumber String 是否隐藏手机号码。1:公开(默认);2:隐藏
orderInDepts String 人员在所在部门内排序。取值范围:1~9999。按数值正序排列。默认为10000。
emailLoginAccount String 邮箱登录账号

请求示例:


curl -X POST \
  'https://open.welink.huaweicloud.com/api/contact/v1/users/bulk' \
  -H 'Accept-Charset: UTF-8' \
  -H 'Content-Type: application/json' \
  -H 'x-wlk-Authorization: access_token' \
  -d '{"请求参数 json格式"}'

响应格式说明

返回结果:

正常返回结果:

{
    "code": "0",
    "message": "成功",
    "data": [
        {
            "corpUserId": "111",
            "code": "47100",
            "message": "等待处理,可通过查询人员异步同步结果接口查询状态"
        }
    ]
}

异常返回结果:

{
    "code": "47101",
    "message": "token格式错误",
    "data": [
    ]
}

返回参数说明:

参数 说明
code 数据正常返回“0”,如果发生错误,会返回对应的错误码。
message 返回信息,包括接口请求发生错误时的详细信息。
data corpUserId:该用户在租户自身系统的登录标识,用于认证和邮箱登录(客户内唯一);
code:状态码;
message:状态描述

错误码说明:

错误码 说明
0 成功
47003 参数为空(邮箱不能为空,部门信息不能为空等)
47004 参数不对(邮箱格式有误,手机号码有误等)
47100 待处理
47101 Token格式错误
47102 无权限
47103 Token过期
47104 处理中
47105 秘书帐号未创建
47106 上级部门未创建
47107 未开户(仅保存成功)
47108 开户中
47109 开户成功
47110 开户失败(携带失败原因)
47111 账户不存在
47112 处理中(无须再提交此数据)
47113 待处理(无须再提交此数据)
47120 登录手机号已被注册

结果。 ""

    无结果。 ""