Skip to content

使用邮箱+验证码注册

使用表单注册并且是邮箱校验时调用本接口。

请求说明

请求头

参数名中文名称必须类型示例
X-operating-sys-version调用方操作系统版本Stringwindows10.1.1
X-device-fingerprint调用方设备指纹String156aysdna213sc50
X-device-ip调用方IPString192.168.1.2
X-agentUser-Agent信息StringMozilla/5.0 (iPhone; CPU iPhone OS 13_3 like Mac OS X)
X-L用于国际化语言设置Stringzh
X-client-id应用授权IDStringnTo1eRIub60vPb54WeE6aojPwYwImtl4
content-type内容格式类型Stringapplication/json

请求示例

json
{
	"user_name": "zhangsan",
	"name": "张三",
	"mobile": "15200000000",
	"email": "15200000000@qq.com",
    "verify_code": "1234",
	"pwd": "QWE@qwe123",
	"head_img": "https://thirdwx.qlogo.cn/mmopen/vi_32/Q0j4TwGTfTIQ8QOTSn3y4cYHLlMC3sv6RCBmeMkxtOog47Zr3v2Afbqc2bmP0WibUIUskX39eJlJ",
	"attr_gender": "male",
	"attr_birthday": "1992-02-17",
	"attr_nick_name": "张三",
	"mailing_address": "湖北省武汉市",
	"zip_code": "430000",
	"first_name": "zhangsan",
	"middle_name": "zhangsan",
	"last_name": "zhangsan",
	"industry": "事业单位",
	"extension": {
		"age": "18"
	}
}

请求参数

WARNING

注意:除了必填的参数外,其他参数需要参考IDaaS用户属性定义中字段是否必填配置

参数名中文名称必须类型描述
user_name用户名String
name姓名String
mobile手机号String
email邮箱String
verify_code邮箱验证码String获取验证码请参考发送邮箱验证码接口 type=REGISTER_EMS
pwd密码String
head_img头像(url)String
attr_gender性别String可选值有: female:女性; male:男性; unknow:保密
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扩展的属性需要在企业中定义

返回示例

成功示例

HTTP/1.1 200 OK

json
{
    "status": "SUCCESS",
    "expire": 43200,
    "session_token": "LGTiTNVDFPlpefV3F3Hla7RUFTqInsqa",
    "id_token": "eyJ0NiJ9.eyJ1cI6IjIifX0.DeWt4QuZXso"
}

错误示例

HTTP/1.1 400 Bad Request

json
{
    "error_code": "IDAAS.SDK.USER.0005",
    "error_msg": "E-mail cannot be empty"
}

返回参数

参数名中文名称类型描述
status返回结果String该字段可能返回的值如下:
SUCCESS 登录成功
ACCESS_DENIED 拒绝访问
expiresession_token有效期Numbersession_token有效期,有效期内可使用session_token获取ticket
session_token用户session_tokenString用户session_token,可使用该token调用IDaaS接口获取sso_ticket,sso_ticket可以换取用户信息
id_token短期有效,接口调用令牌String该字段为jwt格式,包含用户身份信息。可参考根据id_token获取用户信息获取用户信息。令牌有效期默认为5分钟,支持可配置

错误码

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

竹云IDaaS开放平台