返回码

返回码描述

1000

一键登录成功，解析result，可得到网络请求参数

1001

运营商通道关闭

1002

运营商信息获取失败

1003

一键登录获取token失败

1007

网络请求失败

1011

点击返回，用户取消免密登录

1014

未知错误

1016

APPID为空

1018

无网络（缺少时间参数）

1019

其他错误

1021

运营商信息获取失败（accessToken失效）

1022

移动、电信预初始化完成

1023

预初始化失败

1025

非联通号段（目前联通号段 46001 46006 46009）针对联通定制版

1031

请求频繁

1032

账户禁用

返回码

返回码描述

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

授权页成功调起

状态码（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

网关服务暂时不可用

错误码

含义

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切换超时

状态码（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

公钥出错

返回码

返回码描述

解决方案

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

切换异常超时

返回码

返回码描述

解决方案

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根证书校验失败，常见于开启了代理抓包的场景

返回码

返回码描述

解决方案

0

成功

403000

网关校验失败(例如验签等等)

1.SDK传的参数与后端要求不一致。

2.请确保从SDK获取数据后，3分钟内请求闪验服务端。

6006

鉴权失败(例如验签等等)

6007

账户余额不足

10022

参数校验不通过

000102

SDK未初始化完成，请联系客服

9999

系统异常

授权页面停留太久，accessToken失效