开发者中心

概述

内层返回码:对应运营商的返回码

1.外层错误码

返回码 返回码描述
1000 一键登录成功,解析result,可得到网络请求参数
1001 运营商通道关闭
1002 运营商信息获取失败
1003 一键登录获取token失败
1007 网络请求失败
1011 点击返回,用户取消免密登录
1014 未知错误
1016 APPID为空
1018 无网络(缺少时间参数)
1019 其他错误
1021 运营商信息获取失败(accessToken失效)
1022 移动、电信预初始化完成
1023 预初始化失败
1025 非联通号段(目前联通号段 46001 46006 46009)针对联通定制版
1031 请求频繁
1032 账户禁用

2.内层错误码

2.1移动

返回码 返回码描述
103000 成功
102507 登录超时(授权页点登录按钮时)
103101 请求异常
103102 包签名错误(社区填写的appid和对应的包名包签名必须一致)
103111 错误的运营商请求(可能是用户正在使用代理或者运营商判断失败导致)
103119 appid不存在
103211 其他错误,联系技术支撑解决问题
103412 无效的请求(1.加密方式错误;2.非json格式;3.空请求等)
103414 参数校验异常
103511 服务器ip白名单校验失败
103811 token为空
103902 scrip失效(短时间内重复登录)
103911 token请求过于频繁,10分钟内获取token且未使用的数量不超过30个
104201 token已失效或不存在(重复校验或失效)
105001 联通取号失败
105002 移动取号失败
105003 电信取号失败
105012 不支持电信取号
105013 不支持联通取号
105018 token权限不足(使用了本机号码校验的token获取号码)
105019 应用未授权(未在开发者社区勾选能力)
105021 当天已达取号限额
105302 appid不在白名单
105312 余量不足(体验版到期或套餐用完)
105313 非法请求
200005 用户未授权(READ_PHONE_STATE)
200010 无法识别sim卡或没有sim卡(android)
200015 短信验证码格式错误
200020 用户取消登录
200021 数据解析异常
200022 无网络
200023 请求超时
200024 数据网络切换失败
200025 未知错误一般出现在线程捕获异常,请配合异常打印分析
200026 输入参数错误
200027 未开启数据网络或网络不稳定
200028 网络异常
200038 异网取号网络请求失败
200039 异网取号网关取号失败
200040 UI资源加载异常
200048 用户未安装sim卡
200050 EOF异常
200060 切换账号(未使用SDK短验时返回)
200072 CA根证书校验失败
200080 本机号码校验仅支持移动手机号
200082 服务器繁忙
200087 授权页成功调起

2.2联通

状态码(status) 信息(msg) 示例说明
101001 授权码不能为空使用SDK 调用置换接口时没有填入授权码
101002 认证的手机号不能为空使用SDK 认证置换时没有填入需要认证的手机号码
101003 UiConfig 不能为空调用openActivity
101004 ApiKey 或PublicKey 不能为空 未进行初始化,调用SDKManager.init()进行初始化
101005 超时 超过了接入方设置的时间
101006 公钥出错 公钥错误,请核对配置的公钥是否与申请的公钥一致
101007 用户取消登录 免密登录时,进入授权页执行了返回操作
102001 选择流量通道失败 取号功能必须使用流量访问,在wifi 和流量同时开启的情况下,
sdk 会选择使用流量进行访问,此返回码代表切换失败!(受不
同机型的影响)
201001 操作频繁请稍后再试 超出10 分钟之内只能访问30 次的限制
302001 SDK 解密异常 服务端返回数据时sdk 会进行解密操作,如果解密出错则出现此错误
302002 网络访问异常sdk 网络请求异常
302003 服务端数据格式出错 服务端返回数据格式错误
10000 请求超时 移动网络复杂,超时时间设置过短时,容易发生超时错误。 建议超时时间设置的长一点,3秒以上。
10001 获取token失败,请先调用预取号接口
10002 服务响应解析异常 取号服务端返回的数据无法正常解析
10003 无法切换至数据网络 wifi和蜂窝数据网络都开启的情况下, 无法强制取号请求从蜂窝数据网络发出。
10004 数据网络未开启 检测到蜂窝数据网络没有开启。
10005 网络判断异常 在进行网络开通情况判断和切换过程中捕获的异常
10007 预取号过期 标准UI版本使用
10010 Http状态码是200,302之外的值 取号接口只处理200和302状态码,其他都作为失败处理。
10011 Https通讯抛出异常 取号接口用到的HttpsURLConnection通信抛出的异常
10012 200 但body为空
10013 跳转地址错误 基本不会发生
10021 初始化失败
10022 网络请求响应为空
10024 Http通讯抛出异常 取号接口用到的HttpURLConnection通信抛出的异常
10025 ios sdk用到的部分异常
10026 ios sdk用到的socket部分错误
100 应用未授权
101 应用秘钥错误 该应用秘钥即为client_secret。
1. 核对应用秘钥是否正确
2. 联系客服详细处理
102 应用无效 1. client_id字段未传
2. client_id字段值错误
103 应用未授权该IP访问
104 应用访问次数不足
105 应用包名不正确 注册应用时填写的包名与实际包名不符,核对包名报备是否正确
106 应用状态非法 应用处于非正常状态
107 商户状态非法 商户处于非正常状态
108 商户请求次数超限额
200 tokenId无效
201 token已失效 登录接口token无效标识。
token即预取号获得的accessCode值,默认有效期30min单次有效
可能原因如下:
1. 已过有效期;
2. 已被消费;
3. 使用不存在的token;
4. 应用标识与token不匹配。例:用应用标识A获取token,而用应用标识B去消费
202 token未授权该应用访问
203 登录鉴权级别不满足接口鉴权要求
300 接口未开放
301 应用未授权访问该接口 client_id无访问相关接口权限,联系客服详细处理
302 IP 未授权码访问该接口 核对client_id所配公网IP是否正确
303 应用访问接口次数超日限额
400 请求参数为空
401 请求参数不完整 核对必填参数:
1. 是否传值
2. 字段名是否正确
402 请求参数非法 1. timeStamp间隔时间太久
2. 其他参数传了不可识别的值:请检查请求参数是否与接口文档相符
600 请求非法
1000 请求解析错误 服务端无法解析请求参数,请检查请求参数是否与接口文档相符
1001 请求已失效 请求时间戳与中国标准时间间隔太久。
处理建议:请使用中国标准时间
1002 验签失败 1. 核对sign生成规则
2. 核对调用生成sign的method
3. 核对公私钥是否匹配
1003 授权码已过期 认证接口token失效标识。
token即预取号获得的accessCode值,默认有效期30min单次有效
可能原因如下:
1. 已过有效期;
2. 已被消费;
3. 使用不存在的token;
4. 应用标识与token不匹配。例:用应用标识A获取token,而用应用标识B去消费
1004 加密方式不支持
1005 RSA加密错误
1010 服务间访问失败
1011 服务间访问错误 系统内部访问,未得到正确结果,联系客服详细处理。
2004 用户不存在
3002 跳转异网取号
3003 本网执行取号失败,不需要重定向
3004 NET取号失败
3005 上网方式为WIFI~~,无法取号~~
3006 urlencode编码失败
3007 请求认证接口异常
3009 非联通号码
3010 网关取号错误
3011 源IP鉴权失败 1. 当前非联通数据网络
2. APN为3gwap,目前仅支持3gnet
3. 物联网卡
3012 网关取号失败 服务内部错误,联系客服详细处理
3013 电信网关取号失败
3014 电信网关取号错误
3015 回调消息缓存已失效
3016 移动网关取号失败
3017 移动网关取号错误
3018 生成授权码失败
3032 APPID不存在
3050 取号网关内部错误
3051 公网IP校验错误 1. 当前非联通数据网络
2. APN为3gwap,目前仅支持3gnet
3. 物联网卡
3052 公网IP无法找到对应省份
3053 公网IP省份编码与输入不符
3054 私网IP校验错误
3055 私网IP查找号码失败
3056 省份暂不支持取号
3057 网关鉴权码查找号码失败
3058 网关鉴权码格式错误
3059 网关鉴权码已失效
3060 网关账号认证失败
3061 网关取号配额不足
3062 IP未授权访问网关
3063 网关并发连接数受限
3064 访问网关参数非法
3065 未授权访问该网关能力
3066 网关服务暂时不可用

2.3电信

错误码 含义
0 请求成功
-64 permission-denied(无权限访问)
-65 API-request-rates-Exceed-Limitations(调用接口超限)
-10001 取号失败
-10002 参数错误
-10003 解密失败
-10004 ip受限
-10005 异网取号回调参数异常
-10006 Mdn取号失败,且属于电信网络
-10007 重定向到异网取号
-10008 超过预设取号阈值
-10009 时间戳过期
-20005 sign-invalid(签名错误)
-20006 应用不存在
-20007 公钥数据不存在
-20100 内部解析错误
-20102 加密参数解析失败
-30001 时间戳非法
-30003 topClass失效,请查看5.3+5.4常见问题。
51002 参数为空
51114 无法获取手机号数据
80000 请求超时
80001 请求网络异常
80002 响应码错误
80003 无网络连接
80004 移动网络未开启
80005 Socket超时异常
80006 域名解析异常
80007 IO异常
80008 No route to host
80009 nodename nor servname provided, or not known
80010 Socket closed by remote peer
80100 登录结果为空
80101 登录结果异常
80102 预登录异常
80103 SDK未初始化
80104 未调用预登录接口
80105 加载nib文件异常
80200 用户关闭界面
80201 其他登录方式
80800 WIFI切换异常
80801 WIFI切换超时

3.内层错误码(230以前版本)

3.1 联通返回码

外层Code为1003

状态码(status) 信息(msg) 解决方案
100 成功
101 鉴权失败 公钥或者apiKey不正确
103 成功(无数据返回)
104 系统繁忙
111 认证失败,(手机号码和认证手机号码不一致,参与计费)
112 认证失败(未取到手机号码)
115 密钥已暂停
1101 公网ip 无效 1.wifi+流量取到wifi的ip
2.数据流量apn为3gwap,应切换至.net
1102 私网ip 无效 无法用私网ip 找到对应的省份信息
1103 待认证的手机号不能为空 认证传入的手机号码为空
1104 授权码为空 传入的授权码为空
1105 参数信息错误 参数名称、内容错误或者参数丢失再或者加密错误
1106 应用密钥信息不匹配 密钥信息与包名不一致,android 还需要校验MD5 信息,也有可能是参数命名错误
1107 余额不足 使用条数不足
1108 调用能力不匹配 取号置换码调用认证能力或者反之
1201 取号失败
1202 认证失败
1203 获取置换码失败
2101 鉴权失败 参数sign 名称错误或者sign 值有误
2102 accessCode 已失效 accessCode 错误或者过期
2103 序列号不存在 序列号与授权码和密钥绑定,序列号不存在时返回,即授权码错误或者密钥信息与前台使用
不是一套,或者seq 已过期
2201 app_id 无效 appid 未激活或者appid 错误
2202 应用信息错误 获取应用信息错误(demo 中data 参数中app 信息错误)
2203 sdk 信息错误 获取sdk 信息错误(demo 中data 参数中sdk 信息错误)
2205 接入信息解析错误 用户接入信息解析失败
2206 流控值超限 用户访问流控超过限制
3201 系统繁忙 服务端系统出现错误
3202 内部网关错误
3203 内部路由错误
3204 无支付权限
3205 当前省份不支持取号
3206 取号功能暂时不可用
3207 不支持此功能
10100 无网络连接
10101 无数据网络连接
10102 ApiKey 或PublicKey 不能为空
10103 超时
10104 用户取消登录
10105 切换登录方式
20100 测试次数超限
20101 10 分钟之内最多只能获取30 个授权码
30200 服务端数据格式出错
100000 通用,未明确定义的其他错误
100001 网络出错 1、apiKey配置错误或者404错误
2、andorid 9.0以上未正确配置http白名单
100002 参数错误 服务未初始化
100003 数据格式错误 服务器返回结果在客户端解析出错
100004 无结果 服务器返回null
100005 数据不匹配 短信上行的认证结果与填入的不匹配计为认证失败
100006 包名不匹配 服务器返回的结果非本app计为失败
100007 apikey为空 应用未填入apiKey密钥
100008 超时 取号或认证时间超过超时时间
1、当前信号弱,或数据未能匹配到
100009 取消 用户取消操作,计为失败
100012 无公钥 应用未填入公钥
100016 公钥出错

3.2 电信返回码

外层Code为1003时

返回码 返回码描述 解决方案
0 请求成功
-64 permission-denied(无权限访问) 电信方权限问题
-65 API-request-rates-Exceed-Limitations(调用接口超限)
-10001 取号失败
-10002 参数错误
-10003 解密失败
-10004 ip受限 ip白名单;电信网关数据更新未及时同步到系统
-10005 异网取号回调参数异常
-10006 Mdn取号失败,且属于电信网络
-10007 重定向到异网取号
-10008 超过预设取号阈值
-10009 时间戳过期
-20005 sign-invalid(签名错误) 1、Android签名配置错误
2、iOS topclass出错
3、在平台修改后未生效(1小时生效)
-20006 应用不存在
-20007 公钥数据不存在
-20100 内部解析错误
-20102 加密参数解析失败
-30001 时间戳非法
-30003 topClass-invalid topclass无效
51002 参数为空
51114 无法获取手机号数据
-7999 服务不可用(其他错误,默认返回值)
-8000 responseCode非200(网络错误,http状态码错误)
-8001 请求网络异常 网络异常;未获取权限;wifi设置level代理;预取号的时候走http,但是app设置了只能走https;没有添加so库
-8002 请求参数异常
-8003 请求超时
-8004 移动网络未开启
-8005 请先初始化SDK
-8100 网络无连接
-8101 获取失败(切换失败)
-8100 无网络连接(网络错误)
-8102 Socket超时异常(读取超时、连接超时)
-8103 域名解析异常 电信DNS解析异常
-8104 IO异常
-8201 响应码错误
-9999 网络故障(networkauth-fail)
-720001 切换异常 切换流量卡时网络不稳定
-720002 切换异常超时

3.3 移动返回码

外层Code为1003/1015时

返回码 返回码描述 解决方案
102101 无网络
102102 网络异常 网络请求出错,一般出现在网络安全策略限制了不能使用http、设备开启了代理或连接的WiFi有网络链接安全策略限制的场景,建议结合SDK日志具体分析
102103 未开启数据网络
102121 用户取消登录
102203 输入参数错误
102223 数据解析异常
102507 登录超时(授权页点登录按钮时)
102508 数据网络切换失败
103000 成功
103101 请求签名错误 1、检查appid和appkey是否有传对
2、iOS工程中的Infoplist.strings国际化文件,添加bundleId对应的key-value。如果app存在本地国际化文件,请在每个本地国际化文件中添加CFBundleIdentifier,各个语言版本文件中都需要添加。
103102 包名/包签名/bundle id错误 1、后台配置信息与移动保存信息不符;
2、iOS本地国际化文件问题
103103 用户不存在
103111 非移动网关IP地址 wifi切数据通道失败;
电信或联通发送取号请求,但被误判为移动运营商;
网关取号出错;
使用了vpn/代理,导致检查ip为非移动网关ip
103211 其他错误 其他错误,需结合SDK日志分析
103273 预取号联通重定向
103414 参数效验异常
103511 ip未添加白名单
104201 token无效或已过期
105002 获取移动手机号码失败/移动网关取号失败 物联网卡,不允许取号
105013 不支持联通取号
200002 手机未安装sim卡
200005 用户未授权(READ_PHONE_STATE)
200006 用户未授权(SEND_SMS)
200007 authType仅使用短信验证码认证
200008 1. authType参数为空;2. authType参数不合法;
200009 应用合法性校验失败(包名包签名未填写正确)
200010 预取号时imsi获取失败或者没有sim卡
200012 取号失败,跳短信验证码登录
200013 短信上行发送短信失败(短信上行)
200014 手机号码格式错误(短验)
200015 短信验证码格式错误
200016 更新KS失败
200017 非移动卡不支持短信上行
200018 不支持网关登录
200019 不支持短信验证码登录
200020 用户取消登录
200021 数据解析异常(服务器异常可重新尝试)
200022 无网络状态/未检测到网络
200023 登录超时 如果用户所处网络信号较差也容易导致超时增加
200024 数据网络切换失败
200025 未知错误一般出现在线程捕获异常,请配合异常打印分析
200026 输入参数错误
200027 预取号时未开启数据流量
200028 网络请求出错 网络请求出错,一般出现在网络安全策略限制了不能使用http、设备开启了代理或连接的WiFi有网络链接安全策略限制的场景,建议结合SDK日志具体分析
200029 请求出错,上次请求未完成
200030 没有初始化参数
200031 生成token失败
200032 KS缓存不存在
200033 复用中间件获取Token失败
200034 预取号token失效
200035 协商ks失败
200036 预取号失败
200037 获取不到openid
200038 电信重定向失败
200039 电信取号接口返回失败
200040 UI资源加载异常 设置的图片必须放在drawable文件夹下,引号内填图片名称,图片支持xml。
200042 授权页弹出异常
200072 CA根证书校验失败 CA根证书校验失败,常见于开启了代理抓包的场景

4.服务端返回码

外层Code为1019或者1002时

返回码 返回码描述 解决方案
0 成功
403000 网关校验失败(例如验签等等) 1.SDK传的参数与后端要求不一致。
2.请确保从SDK获取数据后,3分钟内请求服务端。
6006 鉴权失败(例如验签等等)
6007 账户余额不足
10022 参数校验不通过
000102 SDK未初始化完成,请联系客服
9999 系统异常 授权页面停留太久,accessToken失效