常见问题 1.支持哪些运营商? 目前支持国内三大运营商,中国移动、中国联通、中国电信。 2.支持哪些手机网络? 网络支持中国移动 2G/3G/4G/5G、中国联通 3G/4G/5G、中国电信 4G/5G. 3.对于 Web SDK,仅支持用户开启数据网络且关闭 Wi-Fi 时进行认证。 对于 Android、iOS SDK 当用户开启数据网络、数据网络 + Wi-Fi 时,可以进行认证。 当用户手机关闭数据网络时,不能进行认证。 注意:2G 网络下认证失败率较高。 4.是否支持双卡手机? 支持双卡手机,双卡手机只能以打开数据网络的 SIM卡 进行认证。 5.认证接口是否有调用频率限制? 为了防止开发者的认证余量被恶意消耗,对应用调用号码认证接口有以下限制。 6.同一个 appKey,单个手机号码提交认证的间隔不少于30秒、一个自然日内消耗认证次数不超过10次 同一个 appKey一个自然日内的认证消耗总量不超过50000次 7.若上述限制不能满足开发者认证的需求,可在极光开发者平台[应用设置]-[认证设置]-[API 调用频率]修改。 8.认证 token 的使用有效期 应用在获取了认证所需的 token 后,token 具有使用有效期。 对于号码认证的 token:移动的号码为2分钟,联通号码为10分钟,电信号码为1分钟。10分钟内获取 token 且未使用的数量不能超过30个,每个 token 只能使用一次,使用一次后即失效。 对于一键登录的 loginToken:移动的号码为2分钟,联通号码为30分钟,电信号码为30分钟。10分钟内获取 loginToken 且未使用的数量不能超过30个。 对于一键登录预取号:移动的号码为30分钟,联通号码为10分钟,电信号码为10分钟。 9.如何获取 Android 应用签名? 您可以在安装了开发者应用的手机上,下载 应用签名获取工具 并安装,来获取 Android 应用签名。 10.日志显示初始化失败,appkey、签名、应用包名无效该如何处理? 检查工程配置的 appkey 与极光控制台上[应用设置]-[应用显示]上显示的是否一致。 检查工程配置的应用包名、Bundle ID 与极光控制台上[极光认证]-[认证设置]-[集成设置]中显示的是否一致。 下载 应用签名获取工具 并安装,将获取的 Android 应用签名与极光控制台上[极光认证]-[认证设置]-[集成设置]中显示的是否一致。 11.一键登录返回 6004 错误码,该如何处理? 问题场景:需要从授权页面,跳转到其他自定义页面(如验证码登录页面)后,重新返回授权页面。重新返回授权页面的时候,再次调用请求授权一键登录接口,此时会返回 6004 错误码。 问题分析:出现该问题是由于在授权页还没有关闭的情况下,再次调用请求授权一键登录接口。 解决方案(选其一): (1)在不关闭授权页面的情况下,从自定义页面返回授权页面时,不需要再次调用一键登录接口,直接关闭当前页面即可回到授权页面。 (2)如果必须要关闭授权页面,需要在跳转自定义页面之前,调用 dismissLogin 接口关闭授权页面,之后再在自定义页面重新调用请求授权一键登录接口。 12.调用 loginTokenVerify API,返回 9021/9020 该如何处理? 检查客户端和后台配置的 appkey 是否一致。 若 appkey 配置一致,检查 loginToken 是否正确,注意 loginToken 不是号码认证的 token。loginToken 获取方法参考:Android SDK 请求授权一键登录、iOS SDK 请求授权一键登录 。 若后台使用 PHP 开发,请确认后台传的 loginToken 与客户端获取的 loginToken 是否一致,若客户端传到后台的 loginToken 的值有 “+”,PHP 会默认把 “+” 替换成空格,导致 loginToken 校验失败。 号码认证和一键登录的 token 具有使用有效期,且每个 token 只能使用一次。 生成秘钥对的时候不要设置证书密码,密钥格式设置为 PKCS#8 。 13.RSA 私钥解密失败,该如何处理? 在 公私钥校验工具 检查公私钥是否匹配。 检查解密参数是否为 loginTokenVerify API 获取的加密后的手机号码。 使用 RSA 解密工具 解密,若能解密成功则说明解密代码有问题,需要排查解密代码逻辑。 14.H5 号码认证返回 2002 错误码,该如何处理? 生产上有 https 访问的,https 请求跨域,会导致上报的 referer 为空,请在 head 中添加代码: 15.如果有强转 https 的设置,需要去掉此设置。 16.如何收费? 认证服务采取预充值、按次计费的收费方式。当一键登录结果为“获取手机号码成功”,或者号码认证结果为“一致”、“不一致”时,会进行计费。