本文档介绍所有状态码的含义及描述
SDK接口回调GyResponse的code含义
| 返回值 | 描述 |
|---|---|
| 30000 | 业务成功 |
| 30004 | 初始化失败 |
| 30005 | 一键登录获取token失败 |
| 30007 | 本机号码校验获取token失败 |
SDK接口回调GYResponse的errorCode含义
| 返回值 | 描述 |
|---|---|
| 0 | 成功 |
| -10000 | sdk没有初始化，请先初始化sdk |
| -10001 | sdk初始化失败，详见整体msg内容 |
| -10003 | 接口请求超时，请稍后重试、加大超时时间或者检查网络 |
| -10006 | 上一个请求正在进行中，请稍后重试 |
| -10009 | 其他错误，详见整体msg内容，比如metadata字段等会有更详细的内容 |
| -20100 | 传入参数错误 |
| -20101 | appid为空 |
| -20102 | appid无效或者签名无效 |
| -20104 | 预登录无效，请先进行预登录 |
| -20200 | 无网络可用，请检查手机网络、或者稍后重试 |
| -20201 | 未插手机电话卡 |
| -20202 | 未开启蜂窝网络 |
| -20203 | 不支持的运营商，请检查手机是否成功连接运营商、以及sdk支持该运营商 |
| -20301 | 登录授权页退出 |
| -20500 | 获取运营商APPID失败，请重启应用重试、或者联系技术支持 |
| -30001 | 服务器返回的其他错误，详见整体metadata内容 |
| -40001 | 运营商返回的其他错误，详见整体metadata内容，会有更详细的内容 |
| -20303 | 用户点击了切换登录按钮 |
| -20304 | 启动登录授权页失败 |
SDK接口回调GYResponse存在metadata时，且格式为{"code":xxxx ,"desc":xxxxx}
| 返回码 | 说明 | 常见原因 | 解决方法 |
|---|---|---|---|
| 10010 | pre_get_token 接口网络错误 | 断网，超时或者跨域 | 检测网络 |
| 10012 | pre_get_token 返回错误 | 数据格式不对 | 1: 数据参数传入错误，appID是否传入 2: 检查是否账户费用不足 3: 服务查看日志 |
| 10030 | 移动获取pretoken接口网络失败 | 断网，超时或者跨域 | 检测网络 |
| 10031 | 移动获取token失败 | 授权页面获取token失败 | 1: 网络是否异常 2: 查看是否输入的是开起数据流量的手机号码 3: 检测网络,服务查看日志 |
| 10032 | 移动获取脱敏手机号失败，非移动流量访问或者非本机号码 | 非移动流量访问 | 1:检查是否开启的是移动流量数据 2:是否开启代理模式 |
| 10033 | 移动获取脱敏手机号失败 | 是否是数据网络，备案Referer是否与当前页面Referer一致 | 1:确认备案Referer，与实际使用页面地址是否一致; 2:确认是否添加header代码； 3:检测网络， 服务查看日志 |
| 10040 | 联通获取token失败 | 是否是数据网络 | 检测网络，服务查看日志 |
| 10041 | 联通验签失败 | 联通验签失败或者IP鉴权错误 | 1: 检测网络，查看是否使用的是联通数据网络; 2: 查看是否开启数据代理模式; 3: 联系个验相关人员，查看日志 |
| 40000 | 目前不支持当前运营商 | 当前不支持电信取号 | 建议降级走其他验证形式 |
| 30001 | 关闭授权页 | 授权页面用户点击返回按钮，关闭授权 | 用户关闭授权页 |
| 30002 | 用户点击切换其他登录方式按钮，关闭授权页 | 授权页面用户用户点击切换其他登录方式按钮，关闭授权 | 用户关闭授权页 |
| 10051 | 电信预取号失败 | 网络或者Referer是否与当前页面Referer一致 | 检查是否开启电信网络,检查备案信息 |
| 10052 | 电信授权失败或者校验失败 | 非本机号码或请求超限制 | 联系个验相关人员，查看日志 |
| 返回码 | 说明 | 常见原因 | 解决方法 |
|---|---|---|---|
| 100 | pre_gateway接口网络失败 | 断网，超时或者跨域 | 检测网络 |
| 101 | pre_gateway接口返回数据错误 | 数据格式不对 | 查看文档确认格式正确 |
| 102 | 接口网络失败 | 断网，超时或者跨域 | 检测网络 |
| 103 | 电信接口失败 | 是否是数据网络 | 检测网络，服务查看日志 |
| 104 | 移动接口失败 | 是否是数据网络，备案refer是否与当前页面refer一致 | 1、确认备案refer，与实际使用页面地址是否一致； 2、确认是否添加header代码； 3、检测网络， 服务查看日志 |
| 105 | record_token接口网络失败 | 断网，超时或者跨域 | 检测网络 |
| 106 | record_token接口失败 | 是否是数据网络 | 检测网络，服务查看日志 |
| 107 | 联通接口失败 | 是否是数据网络 | 检测网络，服务查看日志 |
| 108 | 切换运营商接口失败 | 接口超时错误 | 检测网络，服务查看日志 |
| 返回码 | 描述 | 处理方式 |
|---|---|---|
| 102507 | 登录超时（授权页点登录按钮时，网络信号较差或者配置的超时时间较短 | 在网络信号较好的地方重试，或者修改 SDK 超时时间配置，适当延长超时时间 |
| 103102 | 包签名错误（后台填写的 APPID 和对应的包名包签名必须一致） | 检查应用的包名、包签名与后台创建应用时配置的包名与包签名是否一致，核对 APPID 是否正确 |
| 103111 | 错误的运营商请求，可能是用户正在使用代理或者运营商判断失败导致 | 在仅开启数据网络的情况下重试 |
| 103511 | 服务器 IP 白名单校验失败 | 请联系客服配置 IP 白名单 |
| 103911 | token 请求过于频繁，10 分钟内获取 token 且未使用的数量不超过30个 | 限制 token 请求频率 |
| 104201 | token 已失效或不存在，重复校验或失效 | 重启应用后尝试 |
| 105001 | 联通卡请求移动 SDK 进行取号失败，或者手机卡运营商识别错误 | 升级最新版本 SDK 或者提供错误日志联系客服解答 |
| 105002 | 移动取号失败，可能物联网卡，不允许取号 | 更换其他可正常通话上网的电话卡尝试 |
| 105003 | 电信卡请求移动 SDK 进行取号失败，或者手机卡运营商识别错误 | 升级最新版本 SDK 或者提供错误日志联系客服解答 |
| 105012 | 电信卡请求移动 SDK 进行取号失败，或者手机卡运营商识别错误 | 升级最新版本 SDK 或者提供错误日志联系客服解答 |
| 105013 | 联通卡请求移动 SDK 进行取号失败，或者手机卡运营商识别错误 | 升级最新版本 SDK 或者提供错误日志联系客服解答 |
| 200072 | CA根证书校验失败 | 一般是开了代理或 VPN 会报错，检查下有没有开代理或 VPN ，或者连接的 wifi 开了代理 |
| 返回码 | 描述 | 处理方式 |
|---|---|---|
| 303 | 应用访问接口次数超日限额 | 第二天重试，或增加阈值 |
| 1001 | 请求已失效 | 同步一下手机设置为北京时间 |
| 3004 | 使用 3GNET 网络取号失败 | 建议使用 4G 网络，或者开关数据网络、飞行模式后重试 |
| 3005 | WIFI 网络下取号失败，或者手机系统限制切换数据失败 | 建议在仅开启数据网络情况下重试 |
| 3009 | 非联通卡请求SDK SDK 进行取号失败，或者手机卡运营商识别错误 | 升级最新版本 SDK 或者提供错误日志联系客服解答 |
| 3011 | 源 IP 鉴权失败，用户的公网非联通 3/4G 网关的 IP | 建议切换、开关数据网络或者开关飞行模式后重试 |
| 102001 | 选择流量通道失败，取号功能必须使用流量访问，在 WIFI 和流量同时开启的情况下，SDK 会选择使用流量进行访问，此返回码代表切换失败！（受不同机型的影响） | 在仅开启数据网络的情况下重试 |
| 201001 | 操作频繁请请稍后再试 | 超出 10 分钟之内只能访问 30 次的限制 |
| 302002 | 网络访问异常 SDK | 网络请求异常 |
| 302003 | 服务端数据格式出错 | 服务端返回数据格式错误 |
| 1102 | 1、公网 IP 无效 2、同102001 返回码 | 建议切换 4G 网络，或者开关数据网络、飞行模式后重试 |
| 返回码 | 描述 | 处理方式 |
|---|---|---|
| -65 | API-request-rates-Exceed-Limitations(调用接口超限),一定时间内连续调用次数较多 | 限制调用频次 |
| -10001 | 取号失败 1、3G 网络取号失败 | 1、在 4G 环境下重新尝试 2、建议切换其它登录方式 |
| -10006 | 电信网络，Mdn取号失败，可能是在非 4G 网络下请求 | 换 4G 网络重试 |
| -10008 | 超过预设取号阀值 | 第二天重试，或增加阈值 |
| -10009 | 时间戳过期 | 请确认本机时间是否正确后重试 |
| -10016 | 安全参数不完整，安全校验失败 | 请确认SDK返回的参数填写正确 |
| -8001/80001 | 1、网络异常导致网络请求失败 2、so库匹配错误 3、项目中错误的 abiFilters配置 |
1、在4G环境下重新尝试；如果 4G 条件下仍失败，在网络良好的环境下重新尝试 2、重新按照标准检验 so 库是否正确，确认so库按要求导入对应so库 3、检查本地是否存在多余的 so 4、检查项目中的abiFilters是否过滤掉设备平台运行必须的 so 库 |
| -8003/80000 | 网络状况较差或者配置的超时时间较短，请求超时 | 换网络环境好的地方重试 |
| -8005/80103 | 调用 SDK 前没有调用初始化方法 | 在使用天翼账号 SDK 接口之前，必须先调用初始化方法 |
| -8100/80004 | 移动数据网络未开启或者未允许当前 APP 使用移动数据网络 | 需要用户允许 APP 使用移动数据网络 |
| -8104/80007 | 网络问题导致 IO 异常 | 受网络环境以及服务稳定性影响，建议重试 |
| 30002 | 无法识别用户网络，非电信用户服务识别运营商 | 返回两个地址可以分别请求，也可以认为是失败 |
| 51114 | 获取数据不存在 1、AccessCode 只能使用一次 2、AccessCode 过期（默认一小时缓存） | 重新调用预授权接口获取 |
| 80102 | so 库匹配异常导致预登录异常 | 参考 80001 错误码处理方式 |
以上文档对您是否有帮助？
