更新时间:2024-01-18 GMT+08:00
分享

创建用户

功能介绍

创建用户。

URI

POST /api/v2/tenant/users

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

该字段内容填为“application/json;charset=utf8”。

Authorization

String

认证凭据,值:Bearer {access_token},access_token通过“获取访问凭据”接口获取。

表2 请求Body参数

参数

是否必选

参数类型

描述

user_name

String

用户名,用户唯一标识,企业内唯一。可在管理门户界面,用户菜单下的用户属性定义中修改必填属性。

password

String

密码,需要满足企业定义的格式。

mobile

String

手机号,企业内唯一。可在管理门户界面,用户菜单下的用户属性定义中修改必填属性

org_code

String

主组织的组织编码,填写企业中存在的组织编码。为空时组织在第一个根组织下。

name

String

姓名,为空值时设置为user_name。可在管理门户界面,用户菜单下的用户属性定义中修改必填属性。

email

String

邮箱。可在管理门户界面,用户菜单下的用户属性定义中修改必填属性。

employee_id

String

员工id。可在管理门户界面,用户菜单下的用户属性定义中修改必填属性。

first_name

String

名字。可在管理门户界面,用户菜单下的用户属性定义中修改必填属性。

middle_name

String

中间名。可在管理门户界面,用户菜单下的用户属性定义中修改必填属性。

last_name

String

姓氏。可在管理门户界面,用户菜单下的用户属性定义中修改必填属性。

pwd_must_modify

Boolean

首次登录是否需要强制修改密码。

缺省值:true

attr_gender

String

性别。可在管理门户界面,用户菜单下的用户属性定义中修改必填属性。

枚举值:

  • unknown:保密

  • male:男

  • female:女

attr_birthday

String

生日,格式为yyyy-mm-dd。可在管理门户界面,用户菜单下的用户属性定义中修改必填属性。

attr_nick_name

String

昵称。可在管理门户界面,用户菜单下的用户属性定义中修改必填属性。

attr_identity_type

String

证件类型。

枚举值:

  • id_card:居民身份证

  • HongKong_Macau_Taiwan_residence_permit:港澳台居住证

  • mainland_travel_permit_for_HongKong_Macao:港澳居民来往内地通行证

  • mainland_travel_permit_for_Taiwan:台湾居民来往大陆通行证

  • chinese_passport:中国护照

  • overseas_passport:海外驾照

  • overseas_driver_license:海外驾照

  • officer_id:军官证

  • foreigner_residence_permit:外国人居留证

  • other:其他

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

自定义扩展属性。

表3 UserOrgRelationListOption

参数

是否必选

参数类型

描述

orgCode

String

组织编码

relationType

String

归属关系,同一用户只能有1个归属,最多9个挂靠。

枚举值:

  • 0:挂靠

  • 1:归属

响应参数

状态码: 201

表4 响应Body参数

参数

参数类型

描述

user_id

String

用户id。

状态码: 400

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误编号。

error_msg

String

错误详情。

请求示例

创建一个用户,用户名zhangsan,手机号12345678901,邮箱zhangsan@example.com。

POST https://{domain_name}/api/v2/tenant/users

Authorization: Bearer 334963fc-1e4a-473b-9096-52a929140...
{
    "user_name": "zhangsan",
    "password": "p******d",
    "org_code": "10000",
    "name": "zhangsan",
    "mobile": "12345678901",
    "email": "zhangsan@example.com",
    "employee_id": "123456789",
    "pwd_must_modify": false,
    "first_name": "F",
    "middle_name": "M",
    "last_name": "L",
    "attr_gender": "male",
    "attr_birthday": "1990-02-01",
    "attr_nick_name": "zhangsan",
    "attr_identity_type": "id_card",
    "attr_identity_number": "123456789",
    "attr_area": "CN",
    "attr_city": "xxx",
    "attr_manager_id": "123456789",
    "attr_user_type": "regular",
    "attr_hire_date": "2021-04-01",
    "attr_work_place": "xxx",
    "user_org_relation_list": [
      {
            "orgCode": "10000",
            "relationType": 1
      },
      {
            "orgCode": "TestOrg1",
            "relationType": 0
      },
      {
            "orgCode": "TestOrg2",
            "relationType": 0
      }
    ],
    "extension": {
        "age": "18"
    }
}

响应示例

状态码: 201

请求成功。

{
  "user_id" : "20210621095935811-5E16-6B3060..."
}

状态码

状态码

描述

201

请求成功。

400

参数无效。

错误码

请参见错误码

分享:

    相关文档

    相关产品