批量导入用户 - BatchImportUser
功能介绍
批量导入用户
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
POST /v1/csms/users/batch-import
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 | 
|---|---|---|---|
| X-Auth-Token | 是 | String | 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 | 
| 参数 | 是否必选 | 参数类型 | 描述 | 
|---|---|---|---|
| total | 是 | Integer | 导入条数 | 
| users | 是 | Array of CreateUserRequest objects | 用户列表 | 
| 参数 | 是否必选 | 参数类型 | 描述 | 
|---|---|---|---|
| user_name | 是 | String | 用户名,用户唯一标识,企业内唯一。 | 
| mobile | 是 | String | 手机号,企业内唯一。 | 
| password | 否 | String | 密码,需要满足企业定义的格式。 | 
| org_code | 否 | String | 主组织的组织编码,填写企业中存在的组织编码。为空时组织在第一个根组织下。 | 
| name | 否 | String | 姓名,为空值时设置为user_name。可在管理门户界面,用户菜单下的用户属性定义中修改必填属性。 | 
|  | 否 | String | 邮箱。可在管理门户界面,用户菜单下的用户属性定义中修改必填属性。 | 
| employee_id | 否 | String | 员工id。可在管理门户界面,用户菜单下的用户属性定义中修改必填属性。 | 
| first_name | 否 | String | 名字。可在管理门户界面,用户菜单下的用户属性定义中修改必填属性。 | 
| middle_name | 否 | String | 中间名。可在管理门户界面,用户菜单下的用户属性定义中修改必填属性。 | 
| last_name | 否 | String | 姓氏。可在管理门户界面,用户菜单下的用户属性定义中修改必填属性。 | 
| pwd_must_modify | 否 | Boolean | 首次登录是否需要强制修改密码。缺省值:true | 
| attr_gender | 否 | String | 性别。 | 
| attr_birthday | 否 | String | 生日,格式为yyyy-mm-dd。 | 
| attr_nick_name | 否 | String | 昵称。 | 
| attr_identity_type | 否 | String | 证件类型。 | 
| attr_identity_number | 否 | String | 证件号码。 | 
| attr_area | 否 | String | 国家或者地区的编码。 | 
| attr_city | 否 | String | 城市。 | 
| attr_manager_id | 否 | String | 直属上级。 | 
| attr_user_type | 否 | String | 人员类型。枚举值:regular:正式 intern:实习 dispatch:劳务派遣 outsourcing:劳务外包 | 
| attr_hire_date | 否 | String | 入职时间,格式为yyyy-MM-dd。 | 
| attr_work_place | 否 | String | 工作地点。 | 
| user_org_relation_list | 否 | Array of UserOrgRelationListOption objects | 用户组织关系集合。若填写,必须包含主组织的信息。 | 
| extension | 否 | Object | 自定义扩展属性。 | 
响应参数
状态码:200
| 参数 | 参数类型 | 描述 | 
|---|---|---|
| error_list | Array of ErrorInfo objects | 失败描述 | 
| total | Integer | 总条数 | 
| success | Integer | 成功条数 | 
| failed | Integer | 失败条数 | 
请求示例
无
响应示例
无
状态码
| 状态码 | 描述 | 
|---|---|
| 200 | 导入情况 | 
错误码
请参见错误码。
 
  