检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
获取图形验证码 功能介绍 获取图形验证码。 URI GET /api/v2/sdk/captcha 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-operating-sys-version 是 String 调用方操作系统版本，例如：Android 10。
校验图形验证码 功能介绍 校验图形验证码。 URI POST /api/v2/sdk/captcha/verify 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 该字段内容填为“application/json;charset=utf8”。
验证码 获取图形验证码 校验图形验证码 获取国际区号 发送短信验证码 父主题： 用户类接口
String 图形验证码校验通过的凭证。该参数获取方式参考校验图形验证码。 响应参数 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误详情。 请求示例 发送短信验证码，给指定手机号
修改密码接口设置密码 PASSWORD_EXPIRED：密码已过期，需要调用密码过期强制修改密码接口设置密码 ACCESS_DENIED：拒绝访问 MFA_AUTH：登录成功但需要进行二次认证，需要调用根据state_Token获取手机号接口、手机和短信验证码二次认证接口进行二次认证
手机号短信验证码二次认证 功能介绍 登录过程中如果需要二次认证，则调用本接口根据手机号、短信验证码认证。 URI POST /api/v2/sdk/mfa/sms 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 该
使用手机号和短信验证码注册 功能介绍 使用手机号和短信验证码注册。 URI POST /api/v2/sdk/register/mobile-verify-code 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String
通过手机号找回密码 功能介绍 用户在登录页面单击忘记密码，并选择通过手机号找回密码时，需要输入手机号、验证码、新的密码并通过图形验证码校验后调用本接口。 URI POST /api/v2/sdk/pwd/update-by-mobile 请求参数 表1 请求Header参数 参数 是否必选
使用短信发送验证码提示“消息余量不足，请联系管理员” 问题描述 用户门户使用短信验证码方式登录、修改绑定手机号码等需要发送短信验证码的场景，提示“消息余量不足，请联系管理员”。 原因分析 在购买创建OneAccess实例时会自动配置内置短信网关，默认赠送每月1000条国内短信，2
询应用侧角色、角色成员等。 用户类接口 系统接口 包括获取服务器时间、获取公钥。 注册接口 包括使用手机号和短信验证码注册。 验证码 包括获取图形验证码、校验图形验证码、获取国际区号、发送短信验证码等。 登录登出 包括用户密码登录、手机短信验证码登录、微信登录、支付宝登录、退出登录等。
选择“通过手机号找回”。 输入手机号，单击“发送验证码”。 输入收到的验证码。 输入新密码，确认新密码。 单击“确认”密码找回成功，使用新密码登录用户门户。 选择“通过邮箱找回”。 输入邮箱，单击“发送验证码”。 输入收到的验证码。 输入新密码，确认新密码。 单击“确认”密码找回成功，使用新密码登录用户门户。
获取国际区号 功能介绍 获取支持的国际区号。 URI GET /api/v2/sdk/country-codes 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-operating-sys-version 是 String 调用方操作系统版本，例如：Android
语音网关配置 语音网关是OneAccess提供的“语音验证码”功能，当用户的手机无法收到短信验证码时，可以通过配置语音网关发送语音验证码，确保业务的连续性。包括内置网关、自定义网关两种方式。 内置网关 使用情况：选择“内置网关”后，可以在语音网关配置页面查看语音的总量和已使用量。
0002 Invalid CAPTCHA code. 图形验证码校验失败 请检查输入项是否正确并重新调用 400 CAPTCHA.0003 CAPTCHA token expired. 图形验证码校验通过令牌已失效 请重新获取和校验图形验证码后再调用 400 CAPTCHA.0004 Invalid
钉钉网关配置 当“短信验证码”和“语音验证码”都无法满足需求时，可以使用钉钉网关发送验证码，在登录用户门户、忘记密码、二次验证、重置密码、风险预警场景，OneAccess同时支持钉钉发送验证码，您只需要通过配置钉钉网关即可实现。 本文主要介绍OneAccess配置钉钉网关的方法。
用户类接口 如何调用API 系统接口 注册 验证码 登录登出 社交账号 密码管理 二次认证 个人信息管理 SSO id_token管理 父主题： API
取短信或验证码的方式。当您选择“内置网关”后，可以在短信网关配置页面查看短信的总量和已使用量。 场景和模板预置：在短信网关配置页面，管理员可以查看获取短信的场景和模板，OneAccess对场景和模板已经进行了预置和注册审核。用户在使用相应场景时，会收到预置的短信或验证码信息。 场
_id。 表2 请求Body参数 参数 是否必选 参数类型 描述 mobile 是 String 接收验证码的手机号。 verify_code 是 String 接收到的验证码。 响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 status String
注册 使用手机号和短信验证码注册 父主题： 用户类接口
_id。 表2 请求Body参数 参数 是否必选 参数类型 描述 mobile 是 String 接收验证码的手机号。 verify_code 是 String 接收到的验证码。 响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 status String
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
