增量导入成员接口

本接口以企业内的 username（用户编号）为主键，更新创建企业成员。（仅支持公共模式）

接口版本：

接口版本	更新时间	版本说明
v1	2018.12.4	使用 _id 作为 id
v2	2019.6.21	使用 username 作为 id
v4	2022.6.30	返回值新增字段 type、status、integrate_id
v5	2022.10.28	在 v4 的基础上，接口请求频率由 5 次/秒提升至 10 次/秒；接口路由修改为 POST corp/user/import

**请求地址：**https://api.jiandaoyun.com/api/v5/corp/user/import

**请求频率：**10 次/秒

**请求方式：**POST

注意事项：

用户编号在企业内唯一，仅支持由字母、数字、下划线组成；

用户昵称最长为 80 个字符；

所有用户必须在部门下，如果导入用户不存在部门，则会移动到根部门下；

通过该接口导入的用户会自动激活，且没有邮箱、密码、手机号等信息，可以配合单点登录功能实现企业用户登录；

如果导入数据存在，但是现有企业通讯录中不存在该用户，则新建成员；

如果导入数据存在，且现有企业通讯录中存在该用户，则更新成员信息；

该接口不会执行删除成员操作；

该接口每次调用允许导入的用户数为 20000；

该接口调用执行期间，将无法同时调用其他对通讯录的修改、删除、新增接口。

请求参数：

参数	是否必需	类型	说明
users	是	Json[]	用户列表
users[].username	是	String	用户编号
users[].name	是	String	昵称
users[].departments	是	Number[]	所在部门编号列表

请求示例：

{
    "users": [{
        "username": "coding_master",
        "name": "小简",
        "departments": [1, 3]
    }]
}

响应内容：

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

响应示例：

{
    "status": "success"
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

users

array [object {3}]

用户列表

必需

username

string

用户编号

可选

name

string

昵称

可选

departments

array[number]

所在部门编号列表

可选

示例

{
    "users": [{
        "username": "coding_master",
        "name": "小简",
        "departments": [1, 3]
    }]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

增量导入成员接口