Skip to content

修改用户部分属性

请求说明

请求头

参数名中文名称必须类型描述
Authorization授权String格式:Bearer {access_token}
Content-Type内容类型String固定值:application/json; charset=utf-8

请求示例

修改用户的姓名示例

json
{
  	"name": "张三"
}

修改用户名、姓名、手机、邮箱、扩展属性等示例

json
{
  	"user_name":"zhangsan",
	"name":"张三",
	"mobile":"15200000000",
	"email":"15200000000@qq.com",
    "head_img": "data:image/jpeg;base64,......."
}

根据请求的用户ID参数更新用户的身份信息,支持更新部分用户属性。如请求参数只包含用户姓名时,系统仅更新用户的姓名,其他用户属性不变。

请求参数

参数名中文名称必须类型描述
user_name用户名String用户名,用户在企业内部的唯一标识,可以在请求参数中指定,如果不传该参数,系统将自动生成
name姓名String
mobile手机号String
email邮箱String
attr_gender性别String可选值有: "unknow":保密 "male":男 "female":女
attr_birthday生日String格式为: yyyy-mm-dd
attr_nick_name昵称String
mailing_address邮寄地址String
zip_code邮政编码String
first_name名字String
middle_name中间名String
last_name姓氏String
industry所属行业String
extension扩展属性JSONObject扩展属性,扩展的属性需要在企业中定义
head_img用户头像String用户头像,支持base 64编码的图片字符串和http、https开头的url

注:企业可根据实际需要在“企业中心-用户属性定义”对系统内置的属性修改是否必填及展示名称(不能删除系统属性),也可以根据企业需求扩展用户属性,接口请求参数以“用户属性定义”模块中定义的属性进行处理。

返回示例

成功示例

HTTP/1.1 200 OK

json
{
  "user_id": "20201028102749564-9082-DC8CD2722"
}

错误示例

HTTP/1.1 400 Bad Request

json
{
  "error_msg": "User not found",
  "error_code": "IDAAS.TENANT.USER.0001"
}

返回参数

参数名中文名称类型描述
user_id用户idString

错误码

状态码错误码中文错误信息英文错误信息处理措施
400IDAAS.TENANT.USER.0001用户未找到User not found请检查对应用户是否存在
400IDAAS.TENANT.USER.0002用户名不能为空Username cannot be empty请检查入参中的用户名字段是否为空
400IDAAS.TENANT.USER.0003姓名不能为空Name cannot be empty请检查入参中的姓名字段是否为空
400IDAAS.TENANT.USER.0004手机号不能为空Mobile number cannot be empty请检查入参中的手机号字段是否为空
400IDAAS.TENANT.USER.0005邮箱不能为空E-mail cannot be empty请检查入参中的邮箱字段是否为空
400IDAAS.TENANT.USER.0007性别不能为空Gender cannot be empty请检查入参中的性别字段是否为空
400IDAAS.TENANT.USER.0008生日不能为空Birthday cannot be empty请检查入参中的生日字段是否为空
400IDAAS.TENANT.USER.0009昵称不能为空Nick name cannot be empty请检查入参中的昵称字段是否为空
400IDAAS.TENANT.USER.0010邮寄地址不能为空Mailing address cannot be empty请检查入参中的邮寄地址字段是否为空
400IDAAS.TENANT.USER.0011邮政编码不能为空Zip code cannot be empty请检查入参中的邮政编码字段是否为空
400IDAAS.TENANT.USER.0012名字不能为空First name cannot be empty请检查入参中的名字字段是否为空
400IDAAS.TENANT.USER.0013中间名不能为空Middle name cannot be empty请检查入参中的中间名字段是否为空
400IDAAS.TENANT.USER.0014姓氏不能为空Last name cannot be empty请检查入参中的姓氏字段是否为空
400IDAAS.TENANT.USER.0015所属行业不能为空Industry cannot be empty请检查入参中的所属行业字段是否为空
400IDAAS.TENANT.USER.0017扩展属性{0}不能为空Extended property {0} cannot be empty请检查入参中的外部ID字段是否为空
400IDAAS.TENANT.USER.0018用户名不符合校验规则The username does not meet the verification rules请检查入参中的用户名字段是否符合【企业中心-用户-用户属性定义】中用户名字段的校验规则
400IDAAS.TENANT.USER.0019姓名不符合校验规则The name does not meet the verification rules请检查入参中的姓名字段是否符合【企业中心-用户-用户属性定义】中姓名字段的校验规则
400IDAAS.TENANT.USER.0020手机号不符合校验规则The mobile number does not meet the verification rules请检查入参中的手机号字段是否符合【企业中心-用户-用户属性定义】中手机号字段的校验规则
400IDAAS.TENANT.USER.0021邮箱不符合校验规则The e-mail does not meet the verification rules请检查入参中的邮箱字段是否符合【企业中心-用户-用户属性定义】中邮箱字段的校验规则
400IDAAS.TENANT.USER.0023性别不符合校验规则The gender does not meet the verification rules请检查入参中的性别字段是否符合【企业中心-用户-用户属性定义】中性别字段的校验规则
400IDAAS.TENANT.USER.0024生日不符合校验规则The birthday does not meet the verification rules请检查入参中的生日字段是否符合【企业中心-用户-用户属性定义】中生日字段的校验规则
400IDAAS.TENANT.USER.0025昵称不符合校验规则The nickname does not meet the verification rules请检查入参中的昵称字段是否符合【企业中心-用户-用户属性定义】中昵称字段的校验规则
400IDAAS.TENANT.USER.0026邮寄地址不符合校验规则The mailing address does not meet the verification rules请检查入参中的邮寄地址字段是否符合【企业中心-用户-用户属性定义】中邮寄地址字段的校验规则
400IDAAS.TENANT.USER.0027邮政编码不符合校验规则The zip code does not meet the verification rules请检查入参中的邮政编码字段是否符合【企业中心-用户-用户属性定义】中生日字段的校验规则
400IDAAS.TENANT.USER.0028名字不符合校验规则The first name does not meet the verification rules请检查入参中的名字字段是否符合【企业中心-用户-用户属性定义】中名字字段的校验规则
400IDAAS.TENANT.USER.0029中间名不符合校验规则The middle name does not meet the verification rules请检查入参中的中间名字段是否符合【企业中心-用户-用户属性定义】中中间名字段的校验规则
400IDAAS.TENANT.USER.0030姓氏不符合校验规则The last name does not meet the verification rules请检查入参中的姓氏字段是否符合【企业中心-用户-用户属性定义】中姓氏字段的校验规则
400IDAAS.TENANT.USER.0031所属行业不符合校验规则The industry does not meet the verification rules请检查入参中的所属行业字段是否符合【企业中心-用户-用户属性定义】中所属行业字段的校验规则
400IDAAS.TENANT.USER.0033扩展属性{0}不符合校验规则The extended attribute {0} does not meet the verification rules请检查入参中的外部ID字段是否符合【企业中心-用户-用户属性定义】中外部ID字段的校验规则
400IDAAS.TENANT.MOBILE.0002未经认证的手机号An unauthenticated cell mobile number请检查【企业中心-企业配置-国际区号配置】是否符合配置规则
400IDAAS.TENANT.USER.0034用户名已存在Username already exists请检查用户是否存在
400IDAAS.TENANT.USER.0035手机号已存在Mobile number already exists删除手机号重新添加或更换未添加过的手机号
400IDAAS.TENANT.USER.0036邮箱已存在E-mail already exists删除邮箱重新添加或更换未添加过的邮箱
400IDAAS.TENANT.USER.0037扩展属性{0}已存在Extended property {0} already exists删除扩展属性{0}重新添加或更换未添加过的扩展属性

竹云IDaaS开放平台