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

请求方式: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": "mmn",
            "corpParentCode": "ddfd",
            "deptNameCn": "生产部门",
            "deptNameEn": "produce dept",
            "deptLevel": "1",
            "managerId": "",
            "valid": "1",
            "orderNo": "1000"
        },
        {
            "corpDeptCode": "lklkl",
            "corpParentCode": "ddfd",
            "deptNameCn": "设计部门",
            "deptNameEn": "design dept",
            "deptLevel": "1",
            "managerId": "",
            "valid":  "1",
            "orderNo": "999",
            "visibleRange": 2
        }
    ]
}

请求参数说明:

参数 参数类型 必填 说明
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。
visibleRange Int 1、全部可见 2、仅自己可见 3、当前部门和子部门可见

请求示例:


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": "待处理,可通过查询部门异步同步结果接口查询状态"
        },
        {
            "corpDeptCode": "lklkl",
            "code": "47003",
            "message": "客户侧部门编码为空"
        }
    ]
}

异常返回结果:

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

返回参数说明:

参数 说明
code 数据正常返回“0”,如果发生错误,会返回对应的错误码。
message 返回信息,包括接口请求发生错误时的详细信息。
data corpDeptCode:企业部门唯一标识(客户内唯一);
code:状态码;
message:状态描述

错误码说明:

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

结果。 ""

    无结果。 ""