批量管理


POST /api/v2/department/import - 全量导入部门

本接口以dept_no(部门编号)主键,全量覆盖企业内的通讯录部门树。

注意事项:

  1. 部门编号为数字类型且唯一
  2. 除了根部门以外所有部门的父部门必须存在。如果新导入列表中不存在根部门, 则会自动插入根部门, 且部门名称为企业名称
  3. 同级部门名称不能有重复
  4. 部门层级不能超过16级
  5. 如果导入数据存在,且现有企业通讯录中也存在,则更新该部门的信息
  6. 如果导入数据存在,而现有企业通讯录中不存在,则新建该部门
  7. 如果导入数据不存在,但现有企业通讯录中存在,则继续判断该部门下是否存在子部门和成员,如果都没有则自动删除该部门,否则继续保留
  8. 该接口允许导入的部门数上限为100000
  9. 该接口调用执行期间,将无法同时调用其他对通讯录的修改、删除、新增接口

请求参数:

参数 必需 类型 说明
departments array 部门列表
departments[].dept_no number 部门编号(上限 9007199254740991)
departments[].name string 部门名称
departments[].parent_no number 父部门编号,不传默认为根部门下

请求数据样例:

{
    "departments": [{
        "dept_no": 11,
        "name": "研发部门",
        "parent_no": 1
    }, {
	 "dept_no": 12,
	 "name": "测试部门",
	 "parent_no": 1
    }]
}

响应内容:

参数 类型 说明
status string 返回请求结果

响应数据样例:

{
    "status": "success"
}

POST /api/v2/user/import - 增量导入用户

本接口以企业内的username(用户编号)主键,更新创建企业成员。

注意事项:

  1. 用户编号在企业内唯一,仅支持由字母、数字、下划线组成
  2. 用户昵称最长为80个字符
  3. 所有用户必须在部门下,如果导入用户不存在部门,则会移动到根部门下
  4. 通过该接口导入的用户会自动激活,且没有邮箱、密码、手机号等信息,可以配合单点登录功能实现企业用户登录
  5. 如果导入数据存在,但是现有企业通讯录中不存在该用户,则新建成员
  6. 如果导入数据存在,且现有企业通讯录中存在该用户,则更新成员信息
  7. 该接口不会执行删除成员操作
  8. 该接口每次调用允许导入的用户数为20000
  9. 该接口调用执行期间,将无法同时调用其他对通讯录的修改、删除、新增接口

请求参数:

参数 必需 类型 说明
users json[] 用户列表
users[].username string 用户编号
users[].name string 昵称
users[].departments number[] 所在部门编号列表

请求数据样例:

{
    "users": [{
        "username": "coding_master",
        "name": "代码大师",
        "departments": [1, 3]
    }]
}

响应内容:

参数 类型 说明
status string 返回请求结果

响应数据样例:

{
    "status": "success"
}
本文是否对您有帮助?
 有帮助
 没帮助
您是否遇到了以下问题?
如需获取即时帮助,请联系技术支持