常见问题

支持哪些运营商?

目前支持国内三大运营商,中国移动、中国联通、中国电信。

支持哪些手机网络?

网络支持中国移动 2G/3G/4G/5G、中国联通 3G/4G/5G、中国电信 4G/5G.

对于 Web SDK,仅支持用户开启数据网络且关闭 Wi-Fi 时进行认证。 对于 Android、iOS SDK 当用户开启数据网络、数据网络 + Wi-Fi 时,可以进行认证。 当用户手机关闭数据网络时,不能进行认证。

注意:2G 网络下认证失败率较高。

是否支持双卡手机?

支持双卡手机,双卡手机只能以打开数据网络的 SIM卡 进行认证。

认证接口是否有调用频率限制?

为了防止开发者的认证余量被恶意消耗,对应用调用号码认证接口有以下限制。

  • 同一个 appKey,单个手机号码提交认证的间隔不少于30秒、一个自然日内消耗认证次数不超过10次

  • 同一个 appKey一个自然日内的认证消耗总量不超过50000次

若上述限制不能满足开发者认证的需求,可在极光开发者平台[应用设置]-[认证设置]-[API 调用频率]修改。

认证 token 的使用有效期

应用在获取了认证所需的 token 后,token 具有使用有效期。

  • 对于号码认证的 token:

    • 移动的号码为2分钟,联通号码为10分钟,电信号码为1分钟。10分钟内获取 token 且未使用的数量不能超过30个,每个 token 只能使用一次,使用一次后即失效。
  • 对于一键登录的 loginToken:

    • 移动的号码为2分钟,联通号码为30分钟,电信号码为30分钟。10分钟内获取 loginToken 且未使用的数量不能超过30个。
  • 对于一键登录预取号:

    • 移动的号码为30分钟,联通号码为10分钟,电信号码为10分钟。

如何获取 Android 应用签名?

您可以在安装了开发者应用的手机上,下载 应用签名获取工具 并安装,来获取 Android 应用签名。

日志显示初始化失败,appkey、签名、应用包名无效该如何处理?

  • 检查工程配置的 appkey 与极光控制台上[应用设置]-[应用显示]上显示的是否一致。
  • 检查工程配置的应用包名、Bundle ID 与极光控制台上[极光认证]-[认证设置]-[集成设置]中显示的是否一致。
  • 下载 应用签名获取工具 并安装,将获取的 Android 应用签名与极光控制台上[极光认证]-[认证设置]-[集成设置]中显示的是否一致。

一键登录返回 6004 错误码,该如何处理?

问题场景:需要从授权页面,跳转到其他自定义页面(如验证码登录页面)后,重新返回授权页面。重新返回授权页面的时候,再次调用请求授权一键登录接口,此时会返回 6004 错误码。

问题分析:出现该问题是由于在授权页还没有关闭的情况下,再次调用请求授权一键登录接口。

解决方案(选其一):

(1)在不关闭授权页面的情况下,从自定义页面返回授权页面时,不需要再次调用一键登录接口,直接关闭当前页面即可回到授权页面。

(2)如果必须要关闭授权页面,需要在跳转自定义页面之前,调用 dismissLogin 接口关闭授权页面,之后再在自定义页面重新调用请求授权一键登录接口。

调用 loginTokenVerify API,返回 9021/9020 该如何处理?

  • 检查客户端和后台配置的 appkey 是否一致。

  • 若 appkey 配置一致,检查 loginToken 是否正确,注意 loginToken 不是号码认证的 token。loginToken 获取方法参考:Android SDK 请求授权一键登录iOS SDK 请求授权一键登录

  • 若后台使用 PHP 开发,请确认后台传的 loginToken 与客户端获取的 loginToken 是否一致,若客户端传到后台的 loginToken 的值有 “+”,PHP 会默认把 “+” 替换成空格,导致 loginToken 校验失败。

  • 号码认证和一键登录的 token 具有使用有效期,且每个 token 只能使用一次。

  • 生成秘钥对的时候不要设置证书密码,密钥格式设置为 PKCS#8 。

RSA 私钥解密失败,该如何处理?

H5 号码认证返回 2002 错误码,该如何处理?

  • 生产上有 https 访问的,https 请求跨域,会导致上报的 referer 为空,请在 head 中添加代码:<meta content="always" name="referrer">

  • 如果有强转 https 的设置,需要去掉此设置。

如何收费?

认证服务采取预充值、按次计费的收费方式。当一键登录结果为“获取手机号码成功”,或者号码认证结果为“一致”、“不一致”时,会进行计费。

产品定价如下:

充值次数(次) 单价(元/次)
X≤1W 0.0285
1W<X≤10W 0.0255
10W<X≤50W 0.0235
50W<X≤100W 0.0225
X>100W 联系商务

Copyright 2011-2020, jiguang.cn, All Rights Reserved.
粤ICP备12056275号-13 深圳市和讯华谷信息技术有限公司

Documentation built with MkDocs.