通讯录用户管理异步批量同步用户

举报
云会议运营喵大人 发表于 2020/02/11 12:31:58 2020/02/11
【摘要】 异步批量同步用户接受用户信息,异步同步到WeLink通讯录,支持批量更新用户信息,每次请求最多支持10个用户。此接口为异步接口,返回的信息仅表明参数是否合法,是否同步成功请访问查询用户异步同步结果接口查询 。请求格式说明请求方式:POST (HTTPS)请求地址:https://open.welink.huaweicloud.com/api/contact/v1/users/bulk认证方式...

异步批量同步用户


接受用户信息,异步同步到WeLink通讯录,支持批量更新用户信息,每次请求最多支持10个用户。

此接口为异步接口,返回的信息仅表明参数是否合法,是否同步成功请访问查询用户异步同步结果接口查询 。

请求格式说明

请求方式:POST (HTTPS)

请求地址:

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

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

请求头部:

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

请求参数:  

{
     "personInfo": [
        {
            "corpUserId": "111",
            "userNameCn" : "张三",
            "userNameEn": "zhangsan",
            "sex": "F",
            "mobileNumber": "+86-15115127336",
            "phoneNumber": "+86-15115127336",
            "corpDeptCode": "1000",
            "userEmail": "zhangsan@huawei.com",
            "landlineNumber": "",
            "addressCode": "1000",
            "corpSecretary": "",
            "isOpenAccount": "1",
            "address": "中国深圳",
            "remark": "test",
            "valid": "1",
            "isHideMobileNumber": "1",
            "orderInDepts": "26"
        }
    ]
}

请求参数说明:  

参数参数类型必填说明
corpUserIdString该用户在租户自身系统的登录标识,用于认证和邮箱登录(客户内唯一)
userNameCnString人员中文名称
userNameEnString人员英文名称
sexString性别。仅:M/F,  M: 男, F: 女
mobileNumbleString绑定手机号码
phoneNumberString手机号码
corpDeptCodeString客户侧部门唯一编码,请先完成部门信息同步,否则传递该字段,系统无法识别该用户的部门
userEmailString邮箱
landlineNumberString座机
addressCodeString邮政编码
corpSecretaryString秘书。在导入用户时,如果秘书帐号还不存在,需要先维护秘书用户信息,再重新同步
isOpenAccountString“1”:表示开户,“0”:表示仅同步不开户
addressString办公位置信息
remarkString备注信息
validString默认为"1", "0"表示该用户已被移除即销户
isHideMobileNumberString是否隐藏手机号码。1:公开(默认);2:隐藏
orderInDeptsString人员在所在部门内排序。取值范围:1~9999。按数值正序排列。默认为10000。

请求示例:  

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": "vvvvv",            "code": "47100",            "message": "waiting for deal"
        },
        {            "corpUserId": "vvvvdvdvd",            "code": "47003",            "message": "The mobile number used for login is empty. "
        },
        {            "corpUserId": "n",            "code": "47004",            "message": "isOpenAccount must be 1 or 0"
        }
    ]
}

异常返回结果:

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

返回参数说明:

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

错误码说明:

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


【版权声明】本文为华为云社区用户原创内容,未经允许不得转载,如需转载请自行联系原作者进行授权。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。