部门信息同步


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

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

请求格式说明

请求方式:POST (HTTPS)

请求地址:

https://open.welink.huaweicloud.com/api/contact/v2/departments/bulk

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

请求头部:

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

请求参数:

{
    "deptInfo": [
        {
            "corpDeptCode": "dddddd",
            "corpParentCode": "ddfd",
            "deptNameCn": "生产部门",
            "deptNameEn": "produce dept",
            "deptLevel": "1",
            "managerId": "",
            "valid": "1"
            "orderNo": "1000"
        },
        {
            "corpDeptCode": "dddddd",
            "corpParentCode": "ddfd",
            "deptNameCn": "设计部门",
            "deptNameEn": "design dept",
            "deptLevel": "1",
            "managerId": "",
            "valid":  "1"
            "orderNo": "999"
        }
    ]
}

请求参数说明:

参数 参数类型 必填 说明
corpDeptCode String 客户侧部门唯一编码
corpParentCode String 客户侧上一级部门编码。注意:同步1级部门时该字段值设置为“0”
deptNameCn String 部门中文名称
deptNameEn String 部门英文名称
deptLevel String 部门级别。1:表示1级部门,2:表示二层部门,以此类推
managerId String 部门主管的ID
valid String 部门状态。1:有效(有效根据是否存在corpDeptCode判断新增还是更新);
0:无效(无效表示已删除)
orderNo String 部门排序。取值范围:1~999。按数值正序排列。默认为1000。

请求示例:


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

响应格式说明

返回结果:

正常返回结果:

{
    "code": "0",
    "message": "OK",
    "data": [
        {
            "corpDeptCode": "mmn",
            "code": "0",
            "message": "waiting for deal"
        },
        {
            "corpDeptCode": "lklkl",
            "code": "47003",
            "message": "corpDeptCode could not be empty"
        },
        {
            "corpDeptCode": "mkkknk",
            "code": "47003",
            "message": "The department level is empty."
        }
    ]
}

异常返回结果:

{
    "code": "47103",
    "message": "Authentication failed",
    "data": []
}

返回参数说明:

参数 说明
code 数据正常返回“0”,如果发生错误,会返回对应的错误码。
message 返回信息,包括接口请求发生错误时的详细信息。
data corpUserId:用户唯一标示;
code:状态码;
message:状态描述

错误码

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

result. ""

    Not Found. ""