请求参数 表1 FormData参数 参数 是否必选 参数类型 描述 code 是 String 授权码，认证登录获取授权码接口返回的授权码。 client_id 是 String 应用标识，注册应用后，分配的ClientId。 client_secret 是 String 应用密钥，注册应用后，分配的ClientSecret。 grant_type 是 String 授权类型，固定值：authorization_code。 redirect_uri 否 String 回调地址，地址可以是注册应用时填写的回调地址，也可以是注册应用时填写的回调地址的 域名 。若传入，则需要与调用认证登录获取授权码接口的入参redirect_url保持一致。

请求示例 获取AccessToken，后续使用该token获取用户信息。code使用认证登录获取授权码接口返回的授权码z2D...，client_id和client_secert使用注册应用时分配的ClientId和ClientSecret，redirect_uri配置为应用的回调地址https://example.com，grant_type为固定值authorization_code。 POST https://{domain_name}/api/v1/oauth2/token Content-Type: application/x-www-form-urlencoded code=z2D...& client_id=NzZeWuiJa91dPSRdZQChMazIh13AW...& client_secret=NzZeWuiJa91dPSRdZQChMazIh13AW...& redirect_uri=https://example.com& grant_type=authorization_code

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 access_token String 授权服务器返回给第三方应用的访问令牌。 token_type String 访问令牌类型。固定值：Bearer。 expires_in Long 访问令牌的有效期，以秒为单位。 scope String 授权范围。 refresh_token String 刷新令牌。默认不生成refresh_token，如果需要，在应用的“认证配置”中设置“Refresh Token有效期”后生成返回。 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error String 错误类型。 error_description String 错误描述。

响应示例 状态码： 200 请求成功。 { "access_token" : "NqM******d3k", "token_type" : "Bearer", "expires_in" : "7200", "scope" : "get_user_info", "refresh_token" : "42e******w24" } 状态码： 400 请求错误。 { "error" : "invalid_grant", "error_description" : "Invalid authorization code" }

响应示例 状态码： 200 请求成功。 { "user_name": "zhangsan", "name": "张三", "head_img": "https://thirdwx.qlogo.cn/mmopen/vi_32/Q0j4TwGTfTIQ8QOTSn3y4cYHLlMC3sv6RCBmeMkxtOog47Zr3v2Afbqc2bmP0WibUIUskX39eJlJAEbAibXs", "email": "12345678901@example.com”, "mobile": "12345678901" "attr_gender":"male", "attr_birthday": "2022-02-17", "attr_nick_name": "张三", "first_name": "zhangsan", "middle_name": "zhangsan", "last_name": "zhangsan", "extension": { "age":"18" } }

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 user_name String 用户名 name String 姓名 head_img String 头像（url） email String 邮箱 mobile String 手机号 attr_gender String 性别。可选值有： female：女性； male：男性； unknow：保密 attr_birthday String 生日。格式为： yyyy-MM-dd attr_nick_name String 昵称 first_name String 名字 middle_name String 中间名 last_name String 姓氏 extension String 扩展属性 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误详情。

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-operating-sys-version 是 String 调用方操作系统版本，例如：Android 10。 X-device-fingerprint 是 String 调用方设备指纹，例如：156aysdna213sc50。 X-device-ip 否 String 调用方IP，例如：10.10.10.1。 X-agent 是 String 用户Agent信息，例如：Mozilla/5.0 (Linux; Android 10; Redmi K30 Build/QKQ1.190825.002; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/80.0.3987.99 Mobile Safari/537.36。 X-L 否 String 用于国际化语言设置，例如：zh。 X-client-id 是 String 应用标识，注册应用后分配的ClientId。 X-signature 是 String 加密数据为session_token=xxx×tamp=xxx&nonce=xxx，其中：session_token为会话凭证，timestamp表示当前时间戳，nonce表示当前时间戳的16进制，加密方式为RSA公钥加密。当前时间戳可调用获取服务器时间接口获取，加密公钥可调用获取公钥接口获取。 X-tenant-id 否 String 租户id，ISV应用调用则为必填，需要将{domain_name}换成ISV通用域名{common_domain}，请求Header参数中需要指定对应租户的tenant_id，并将X-client-id换成ISV应用模板的client_id。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 status String 返回结果。 枚举值： SUC CES S：登录成功 ACCESS_DENIED：拒绝访问 expire Integer session_token有效期，单位为秒，有效期内可使用session_token获取ticket。 session_token String 用户session_token，可使用该token调用单点登录接口获取sso_ticket，通过sso_ticket可以获取用户信息。 id_token String 本质上是一个JWT Token，包含了用户身份信息，默认2小时有效，支持可配置。 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误详情。

请求示例 使用手机号和短信验证码注册用户。用户名为zhangsan，姓名为张三，手机号为12345678901，短信验证码为1234，邮箱为12345678901@example.com，密码为Q******3。自定义扩展字段年龄值为18。 POST https://{domain_name}/api/v2/sdk/register/mobile-verify-code X-operating-sys-version: Android 10 X-device-fingerprint: 156aysdna213sac X-device-ip: 10.10.10.1 X-agent: Mozilla/5.0 (Linux; Android 10; Redmi K30 Build/QKQ1.190825.002; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/80.0.3987.99 Mobile Safari/537.36 X-L: zh X-client-id: DRrYIqauawN0I8myTMoDTPys6ezGZxnm X-tenant-id: 08f770f51f80d2f40f38c00cb199fd21 { "user_name": "zhangsan", "name": "张三", "mobile": "12345678901", "verify_code": "1234", "email": "12345678901@example.com", "pwd": "Q******3", "head_img": " https://thirdwx.qlogo.cn/mmopen/vi_32/Q0j4TwGTfTIQ8QOTSn3y4cYHLlMC3sv6RCBmeMkxtOog47Zr3v2Afbqc2bmP0WibUIUskX39eJlJ", "attr_gender": "male", "attr_birthday": "2022-02-17", "attr_nick_name": "张三", "first_name": "zhangsan", "middle_name": "zhangsan", "last_name": "zhangsan", "extension": { "age": "18" } }

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 该字段内容填为“application/json;charset=utf8”。 X-operating-sys-version 是 String 调用方操作系统版本，例如：Android 10。 X-device-fingerprint 是 String 调用方设备指纹，例如：156aysdna213sc50。 X-device-ip 否 String 调用方IP，例如：10.10.10.1。 X-agent 是 String 用户Agent信息，例如：Mozilla/5.0 (Linux; Android 10; Redmi K30 Build/QKQ1.190825.002; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/80.0.3987.99 Mobile Safari/537.36。 X-L 否 String 用于国际化语言设置，例如：zh。 X-client-id 是 String 应用标识，注册应用后分配的ClientId。 X-tenant-id 否 String 租户id，ISV应用调用则为必填，需要将{domain_name}换成ISV通用域名{common_domain}，请求Header参数中需要指定对应租户的tenant_id，并将X-client-id换成ISV应用模板的client_id。 表2 请求Body参数 参数 是否必选 参数类型 描述 user_name 否 String 用户名。 name 否 String 姓名。 mobile 是 String 手机号。 verify_code 是 String 短信验证码。 email 否 String 邮箱。 pwd 否 String 密码。 head_img 否 String 头像，填写url地址。 attr_gender 否 String 性别。 枚举值： unknown：保密 male：男性 female：女性 attr_birthday 否 String 生日，格式为yyyy-MM-dd。 attr_nick_name 否 String 昵称。 first_name 否 String 名字。 middle_name 否 String 中间名。 last_name 否 String 姓氏。 extension 否 Object 自定义扩展属性。

请求示例 修改个人信息。 POST https://{domain_name}/api/v2/sdk/profile/update X-operating-sys-version: Android 10 X-device-fingerprint: 156aysdna213sac X-device-ip: 10.10.10.1 X-agent: Mozilla/5.0 (Linux; Android 10; Redmi K30 Build/QKQ1.190825.002; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/80.0.3987.99 Mobile Safari/537.36 X-L: zh X-client-id: DRrYIqauawN0I8myTMoDTPys6ezGZxnm X-signature:D0JeOUuVqU8Ixvl0xrmewQRk4AuGZrtk1RfBxueNKUrNPpgSbXrYnzw... X-tenant-id: 08f770f51f80d2f40f38c00cb199fd21 { "user_name": "zhangsan", "name": "张三", "head_img": "https://thirdwx.qlogo.cn/mmopen/vi_32/Q0j4TwGTfTIQ8QOTSn3y4cYHLlMC3sv6RCBmeMkxtOog47Zr3v2Afbqc2bmP0WibUIUskX39eJlJAEbAibXs", "attr_gender": "male", "attr_birthday": "2022-02-17", "attr_nick_name": "张三", "first_name": "zhangsan", "middle_name": "zhangsan", "last_name": "zhangsan", "extension": { "age": "18" } }

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 该字段内容填为“application/json;charset=utf8”。 X-operating-sys-version 是 String 调用方操作系统版本，例如：Android 10。 X-device-fingerprint 是 String 调用方设备指纹，例如：156aysdna213sc50。 X-device-ip 否 String 调用方IP，例如：10.10.10.1。 X-agent 是 String 用户Agent信息，例如：Mozilla/5.0 (Linux; Android 10; Redmi K30 Build/QKQ1.190825.002; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/80.0.3987.99 Mobile Safari/537.36。 X-L 否 String 用于国际化语言设置，例如：zh。 X-client-id 是 String 应用标识，注册应用后分配的ClientId。 X-signature 是 String 加密数据为session_token=xxx×tamp=xxx&nonce=xxx，其中：session_token为会话凭证，timestamp表示当前时间戳，nonce表示当前时间戳的16进制，加密方式为RSA公钥加密。当前时间戳可调用获取服务器时间接口获取，加密公钥可调用获取公钥接口获取。 X-tenant-id 否 String 租户id，ISV应用调用则为必填，需要将{domain_name}换成ISV通用域名{common_domain}，请求Header参数中需要指定对应租户的tenant_id，并将X-client-id换成ISV应用模板的client_id。 表2 请求Body参数 参数 是否必选 参数类型 描述 user_name 否 String 用户名。 name 否 String 姓名。 mobile 是 String 手机号。 verify_code 是 String 短信验证码。 email 否 String 邮箱。 pwd 否 String 密码。 head_img 否 String 头像，填写url地址。 attr_gender 否 String 性别。 枚举值： unknown：保密 male：男性 female：女性 attr_birthday 否 String 生日，格式为yyyy-MM-dd。 attr_nick_name 否 String 昵称。 first_name 否 String 名字。 middle_name 否 String 中间名。 last_name 否 String 姓氏。 extension 否 Object 自定义扩展属性。

错误码 状态码 错误码 错误信息 描述 处理措施 400 APP.0001 Application does not exist. 应用不存在 请检查对应应用是否存在 400 APP.0002 Application ID required. 应用ID不能为空 请检查入参中的应用ID字段是否为空 400 APP.0003 Application disabled. 应用已禁用 请联系管理员或换一个未禁用的应用再试 400 APP_ACCOUNT.0001 Application account does not exist. 应用账号不存在 请检查对应应用账号是否存在 400 APP_ACCOUNT.0002 Application account already exists. 应用账号已存在 更换未添加过的应用账号 400 APP_ACCOUNT.0003 Unsupported application account. 不支持此应用账号类型 请检查应用账号类型是否正确 400 APP_ACCOUNT.0004 Unsupported application account permission. 不支持此应用账号权限类型 请检查应用账号权限类型是否正确 400 APP_ACCOUNT.0006 Public account does not exist. 应用公共账号不存在 请检查对应应用公共账号是否存在 400 APP_ACCOUNT.0007 Extended attribute does not exist. 应用账号扩展属性不存在 请检查对应应用账号扩展属性是否存在 400 APP_ACCOUNT.0008 The name of the application account required. 应用账号名称不能为空 请检查入参中的应用账号名称字段是否为空 400 APP_ACCOUNT.0035 Application account name required. 应用账号名不能为空 请检查入参中的应用账号名字段是否为空 400 APP_ACCOUNT.0036 Application account name invalid. 应用账号名不符合校验规则 请检查入参中的应用账号名字段是否符合校验规则 400 APP_ORG.0001 Application organization does not exist. 应用机构不存在 请检查对应应用机构是否存在 400 APP_ORG.0002 Application organization is not enabled. 应用机构未开启 请检查对应应用是否开启应用机构 400 APP_ORG.0003 Application organization code already exists. 应用机构编码已存在 更换未添加过的应用机构编码 400 APP_ORG.0004 Parent application organization does not exist. 父级应用机构不存在 请检查对应应用机构是否存在 400 APP_ORG.0005 Application organization cannot be modified. 应用机构不能被修改 请检查对应应用是否是租户名下的应用 400 APP_ORG.0006 Application organization and its parent must be different. 父级应用机构和应用机构不能是同一个 请检查父级应用机构是否和应用机构是同一个机构 400 APP_ORG.0007 Application organizations cannot be deleted. 应用机构不能被删除 请检查对应应用机构下是否存在子机构或用户 400 APP_ORG.0008 Application organization code required. 应用机构编码不能为空 请检查入参中的应用机构编码字段是否为空 400 APP_ORG.0009 Application organization name required. 应用机构名称不能为空 请检查入参中的应用机构名称字段是否为空 400 APP_ORG.0010 Application organization name already exists. 应用机构名称已存在 更换同层级下未添加过的应用机构名称 400 APP_ORG.0011 Invalid application organization code. 应用机构编码不符合校验规则 请检查入参中的应用机构编码字段是否符合校验规则 400 APP_ORG.0012 Invalid application organization name. 应用机构名称不符合校验规则 请检查入参中的应用机构名称字段是否符合校验规则 400 APP_ROLE.0001 Application role does not exist. 应用角色不存在 请检查对应应用角色是否存在 400 APP_ROLE.0002 Application role is not enabled. 应用角色未开启 请检查对应应用是否开启应用角色 400 APP_ROLE.0003 Application role already exists. 应用角色已存在 更换未添加过的应用角色 400 APP_ROLE.0004 Application role is bound to accounts. 应用角色存在账号绑定 请先解绑应用账号 400 APP_ROLE.0005 Application role code required. 应用角色代码不能为空 请检查入参中应用角色代码是否为空 400 APP_ROLE.0006 Application role code invalid. 应用角色代码不符合校验规则 请检查入参中的应用角色代码字段是否符合校验规则 400 APP_ROLE.0007 Application role name required. 应用角色名称不能为空 请检查入参中应用角色名称是否为空 400 APP_ROLE.0008 Application role name invalid. 应用角色名称不符合校验规则 请检查入参中的应用角色名称字段是否符合校验规则 400 CAPTCHA.0002 Invalid CAPTCHA code. 图形验证码校验失败 请检查输入项是否正确并重新调用 400 CAPTCHA.0003 CAPTCHA token expired. 图形验证码校验通过令牌已失效 请重新获取和校验图形验证码后再调用 400 CAPTCHA.0004 Invalid CAPTCHA token. 图形验证码校验通过令牌校验失败 输入的令牌和校验图形验证码中返回的令牌不一致 400 CAPTCHA.0005 Unsupported scenario. 不支持此发送场景 请检查发送方式是否正确 400 CAPTCHA.0006 Failed to send the verification code. 验证码发送失败 请检查输入项是否正确并重新调用 400 CAPTCHA.0007 Incorrect verification code. 验证码不正确 请检查输入的验证码是否正确 400 COM.0002 System busy. Please try again later. 系统繁忙，请稍后重试 请联系管理员 400 LOG IN.0001 User has been locked due to multiple login failures. It will be unlocked in {0} minutes and {1} seconds. 由于多次登录失败，用户已被锁定。 它将在 {0} 分钟和 {1} 秒内解锁 请解锁后重试 400 LOGIN.0002 Invalid account name or password. Remaining attempts: {0} 无效的账号或密码。 剩余次数:{0} 请检查输入的用户名或密码是否正确 400 LOGIN.0003 id_token generate error. id_token 生成失败 请检查输入的用户名或密码是否正确 400 MOBILE.0002 Unauthenticated mobile number. 未经认证的手机号 请检查输入的手机号是否正确 400 ORG.0001 Organization does not exist. 组织不存在 请检查对应组织是否存在 400 ORG.0002 Parent organization does not exist. 父级组织不存在 请检查对应父组织是否存在 400 ORG.0010 Organization code required. 组织编码不能为空 请检查组织编码 400 ORG.0011 Organization name required. 组织名称不能为空 请检查入参中的组织名称字段是否为空 400 ORG.0012 Organization code already exists. 组织编码已存在 更换未添加过的组织编码 400 ORG.0014 Invalid organization code. 组织编码不符合校验规则 请检查入参中的组织代码字段是否符合校验规则 400 ORG.0015 Invalid organization name. 组织名称不符合校验规则 请检查入参中的组织名称字段是否符合校验规则 400 ORG.0016 Organizations cannot be deleted. 组织不能被删除 请检查对应组织下是否存在子组织或用户 400 ORG.0017 Organization and its parent must be different. 父组织与当前组织不允许重复 请检查父组织与当前组织不允许重复 400 PAGE.0001 Number of records per page is invalid. 每页数量不符合校验规则 请检查输入每页数量 400 PA RAM .0001 Incomplete device information. 设备信息不完整 请检查输入的设备信息是否完整 400 PARAM.0002 clientId required. clientId不能为空 请检查输入的clientId是否为空 400 PARAM.0004 Coordinates required. 坐标信息不能为空 请检查输入的坐标信息是否为空 400 PARAM.0005 Token required. 图形验证码身份令牌不能为空 请检查输入的图形验证码身份令牌是否为空 400 PARAM.0006 Sender required. 发送方不能为空 请检查输入的发送方是否为空 400 PARAM.0007 Scenario required. 发送场景不能为空 请检查输入的发送场景是否为空 400 PARAM.0008 CAPTCHA token required. 图形验证码校验通过令牌不能为空 请检查输入的图形验证码校验通过令牌是否为空 400 PARAM.0009 Verification code required. 验证码不能为空 请检查输入的验证码是否为空 400 PARAM.0010 Account required. 账号不能为空 请检查输入的账号是否为空 400 PARAM.0011 WeChat authorization code required. 微信授权码不能为空 请检查输入的微信授权码是否为空 400 PARAM.0012 Alipay authorization code required. 支付宝授权码不能为空 请检查输入的支付宝授权码是否为空 400 PARAM.0013 State token required. 临时令牌不能为空 请检查输入的临时令牌是否为空 400 PARAM.0014 Invalid state token. 临时令牌无效 请检查输入的临时令牌是否正确 400 PARAM.0017 PARAM.0017 社交ID不能为空 请检查输入的社交ID是否为空 400 PARAM.0018 Old password required. 原密码不能为空 请检查入参中的原密码字段是否为空 400 PARAM.0019 New password required. 新密码不能为空 请检查入参中的新密码字段是否为空 400 PARAM.0020 Old and new passwords must be different. 原密码和新密码不能一致 请检查输入的原密码和新密码是否一致 400 PARAM.0028 Old password is incorrect. 原密码校验失败 请重新输入密码 400 PARAM.0029 Invalid list. 集合大小不符合校验规则 请检查入参中的集合大小是否符合校验规则 400 PARAM.0030 Signature invalid or expired. 签名无效或已过期 请重新生成签名后再试 400 PARAM.0031 SSO ticket required. 一次性令牌不能为空 请检查输入的一次性令牌是否为空 400 PARAM.0032 SSO ticket invalid or expired. 一次性令牌无效或已过期 请重新获取一次性令牌后再试 400 PWD.0001 Historical passwords cannot be used. 不允许使用历史密码 不允许使用历史密码，请重新输入密码 400 PWD.0002 Password cannot be the username spelled backwards. 密码不允许使用用户名的倒写 密码不允许使用用户名的倒写，请重新输入密码 400 PWD.0003 Password cannot include username, mobile number, or email prefix. 密码中不允许包含：用户名、手机号、邮箱前缀、姓名拼音 密码中不允许包含：用户名、手机号、邮箱前缀、姓名拼音，请重新输入密码 400 PWD.0004 Weak password. 密码复杂度低 密码复杂度低，请重新输入密码 400 PWD.0005 Weak password. 该密码为弱密码 该密码为弱密码，请重新输入密码 400 PWD.0006 Max. {0} identical characters in password. 密码中最大字符重复数不能超过{0} 密码中最大字符重复数不能超过{0}，请重新输入密码 400 PWD.0007 Password must be {0} to {1} characters. 密码长度为{0}~{1}个字符 密码长度为{0}~{1}个字符，请重新输入密码 400 PWD.0008 Password required. 密码不能为空 请检查输入的密码是否为空 400 SOCIAL.0001 Social media account already bound to another account. Unbind them first. 社交账号已绑定，请先解绑 请检查社交账号是否已绑定，或换个手机号进行绑定 400 USER.0001 User does not exist. 用户不存在 请检查对应用户是否存在 400 USER.0004 User disabled. 姓氏不能为空 请联系管理员 400 USER.0008 Username required. 用户名不能为空 请检查入参中的用户名字段是否为空 400 USER.0009 Name required. 姓名不能为空 请检查入参中的姓名字段是否为空 400 USER.0010 Mobile number required. 手机号不能为空 请检查入参中的手机号字段是否为空 400 USER.0011 Email address required. 邮箱不能为空 请检查入参中的邮箱字段是否为空 400 USER.0012 First name required. 名字不能为空 请检查入参中的名字字段是否为空 400 USER.0013 Middle name required. 中间名不能为空 请检查入参中的中间名字段是否为空 400 USER.0014 Last name required. 姓氏不能为空 请检查入参中的姓氏字段是否为空 400 USER.0015 Nickname required. 昵称不能为空 请检查入参中的昵称字段是否为空 400 USER.0016 Birth date required. 生日不能为空 请检查入参中的生日字段是否为空 400 USER.0017 Gender required. 性别不能为空 请检查入参中的性别字段是否为空 400 USER.0018 ID type required. 证件类型不能为空 请检查入参中的证件类型字段是否为空 400 USER.0019 ID number required. 证件号码不能为空 请检查入参中的证件号码字段是否为空 400 USER.0020 Country/region required. 国家或地区不能为空 请检查入参中的国家或地区字段是否为空 400 USER.0021 City required. 城市不能为空 请检查入参中的城市字段是否为空 400 USER.0022 Employee ID required. 工号不能为空 请检查入参中的工号字段是否为空 400 USER.0024 Immediate supervisor required. 直属上级不能为空 请检查入参中的直属上级字段是否为空 400 USER.0026 On-boarding date required. 入职时间不能为空 请检查入参中的入职时间字段是否为空 400 USER.0027 Office location required. 工作所在地不能为空 请检查入参中的工作所在地字段是否为空 400 USER.0028 Extended attribute {0} required. 扩展属性{0}不能为空 请检查入参中的扩展属性{0}字段是否为空 400 USER.0029 Username already exists. 用户名已存在 更换未添加过的用户名 400 USER.0030 Mobile number already exists. 手机号已存在 更换未添加过的手机号 400 USER.0031 Email address already exists. 邮箱已存在 更换未添加过的邮箱 400 USER.0032 ID number already exists. 证件号码已存在 更换未添加过的证件号码 400 USER.0033 Employee ID already exists. 工号已存在 更换未添加过的工号 400 USER.0035 Extended attribute {0} already exists. 扩展属性{0}已存在 更换未添加过的扩展属性{0} 400 USER.0036 Invalid username. 用户名不符合校验规则 请检查入参中的用户名字段是否符合【管理门户-用户-用户属性定义】中的校验规则 400 USER.0037 Invalid name. 姓名不符合校验规则 请检查入参中的姓名字段是否符合【管理门户-用户-用户属性定义】中的校验规则 400 USER.0038 Invalid mobile number. 手机号不符合校验规则 请检查入参中的手机号字段是否符合【管理门户-用户-用户属性定义】中的校验规则 400 USER.0039 Invalid email address. 邮箱不符合校验规则 请检查入参中的邮箱字段是否符合【管理门户-用户-用户属性定义】中的校验规则 400 USER.0040 Invalid first name. 名字不符合校验规则 请检查入参中的名字字段是否符合【管理门户-用户-用户属性定义】中的校验规则 400 USER.0041 Invalid middle name. 中间名不符合校验规则 请检查入参中的中间名字段是否符合【管理门户-用户-用户属性定义】中的校验规则 400 USER.0042 Invalid last name. 姓氏不符合校验规则 请检查入参中的姓氏字段是否符合【管理门户-用户-用户属性定义】中的校验规则 400 USER.0043 Invalid nickname. 昵称不符合校验规则 请检查入参中的昵称字段是否符合【管理门户-用户-用户属性定义】中的校验规则 400 USER.0044 Invalid birth date. 生日不符合校验规则 请检查入参中的生日字段是否符合【管理门户-用户-用户属性定义】中的校验规则 400 USER.0045 Invalid gender. 性别不符合校验规则 请检查入参中的性别字段是否符合【管理门户-用户-用户属性定义】中的校验规则 400 USER.0046 Invalid ID type. 证件类型不符合校验规则 请检查入参中的证件类型字段是否符合【管理门户-用户-用户属性定义】中的校验规则 400 USER.0047 Invalid ID number. 证件号码不符合校验规则 请检查入参中的证件号码字段是否符合【管理门户-用户-用户属性定义】中的校验规则 400 USER.0048 Invalid country or region. 国家或地区不符合校验规则 请检查入参中的国家或地区字段是否符合【管理门户-用户-用户属性定义】中的校验规则 400 USER.0049 Invalid city. 城市不符合校验规则 请检查入参中的城市字段是否符合【管理门户-用户-用户属性定义】中的校验规则 400 USER.0050 Invalid employee ID. 工号不符合校验规则 请检查入参中的工号字段是否符合【管理门户-用户-用户属性定义】中的校验规则 400 USER.0052 Invalid immediate supervisor. 直属上级不符合校验规则 请检查入参中的直属上级字段是否符合【管理门户-用户-用户属性定义】中的校验规则 400 USER.0053 Invalid user type. 人员类型不符合校验规则 请检查入参中的人员类型字段是否符合【管理门户-用户-用户属性定义】中的校验规则 400 USER.0054 Invalid on-boarding date. 入职时间不符合校验规则 请检查入参中的入职时间字段是否符合【管理门户-用户-用户属性定义】中的校验规则 400 USER.0055 Invalid office location. 工作所在地不符合校验规则 请检查入参中的工作所在地字段是否符合【管理门户-用户-用户属性定义】中的校验规则 400 USER.0056 Extended attribute {0} is invalid. 扩展属性{0}不符合校验规则 请检查入参中的扩展属性{0}字段是否符合【管理门户-用户-用户属性定义】中的校验规则 400 USER.0061 User ID required. 用户ID不能为空 请检查入参中的用户ID字段是否为空 父主题： 附录

请求示例 查询CAS1.0接口验证票据，参数分别配置应用回调地址https://example.com及认证登录接口获取的认证票据ST-eYlKs8FrLCltwRwfm8AiwCxmQ8gAL...，获取用户属性信息。 GET https://{domain_name}/api/v1/cas/validate?service=https://example.com&ticket=ST-eYlKs8FrLCltwRwfm8AiwCxmQ8gAL...

入门指引 OneAccess 最基础的入门操作包括添加组织机构、添加用户、添加应用，通过这三个操作就能开始进行集中式身份管理、身份认证和应用管理。 图1为OneAccess基本的入门使用流程，如需了解更多操作，请查看用户指南对应章节。本文旨在帮助您对OneAccess的入门操作有初步的认识，完成这些操作后，管理员可以在OneAccess管理门户对用户和应用进行详细配置和管理，用户可以在OneAccess用户门户单点登录访问已授权可信应用。 图1 入门使用流程 在使用 应用身份管理 服务前，管理员需要参考购买实例购买实例。 管理员购买OneAccess实例后，参考管理员登录管理门户登录至OneAccess管理门户。 组织用于对企业人员进行管理，一个公司或部门可对应一个组织，将其拥有的人员集中在该组织下。顶层组织作为根节点，可以在其下添加多个子组织与用户，同时，在子组织下可继续添加多层组织与用户。参考管理员添加组织添加组织。 参考管理员添加用户管理员在OneAccess管理门户添加用户。 OneAccess平台提供了1000+预集成应用，同时提供自建应用功能，参考管理员添加应用并授权添加应用并授权。 管理员添加组织、用户、应用，并为所添加用户授权后，可以参考用户登录用户门户并进入应用登录OneAccess用户门户并直接进入应用。