快速找到所需文档，高效完成接入与排障

返回编码

返回信息

描述及建议

2001

gain mobile’s result success

获取运营商数据成功

2002

gain mobile’s result and single evaluation score

获取运营商数据成功,并有一个友盟评估结果

2003

gain mobile’s result and two evaluation score

获取运营商数据成功,并有两个友盟评估结果

-2201

系统异常

API智能认证报错-2201，是因为系统异常，

1. 请检查添加的Appkey是否是友盟提供的Appkey，请不要添加阿里云提供的Appkey，如果不对，请更换下试试。

2. 请检查当前使⽤的token⽣成时的密钥是否和当前后台同⼀应⽤下存在的⽅案⾥的密钥⼀致。

若还未解决您的问题 创建工单反馈

-2202

请求超时

创建工单反馈，提供返回的requestID

-2209

系统错误

创建工单反馈，提供返回的requestID

-2210

未知错误

创建工单反馈，提供返回的requestID

-2211

运营商限制或流控限制

目前只支持电信移动和联通三大供应商

-2212

令牌无效

token已过期，请重新获取

-2213

参数不匹配

请检查请求参数

-2214

参数异常

请检查请求参数

-2215

无权操作

创建工单反馈

-2216

非法的app请求

原因为：请求中传入的客户 ID（Client ID）与系统中查询到的认证场景所绑定的客户 ID 不一致，即请求来源身份校验失败。

建议操作：

• 检查请求参数中传入的 客户 ID（Client ID） 是否正确；

-2217

认证方案不存在

请确认是否已经在控制台创建方案，并核对创建时的包名包签名或bundleid与实际使用是否一致

-2218

认证方案冲突

请确认同账号下是否有相同包名包签名或bundleid的方案

-2219

token参数非法

请确认token参数是否与客户端返回的一致

-2220

号码格式非法

本机号码验证无法验证传入的手机号

-2221

网关异常

创建工单反馈，提供返回的requestID

-2222

执行异常

创建工单反馈，提供返回的requestID

-2223

越权使用的token

使用本机号码校验的token调用了一键登录的接口

-2257

触发app访问额度限制，请及时处理

一旦达到app每日访问最大值，之后所有设备的请求都将返回该错误码，请切换到其它登录方式，以免影响正常设备登录

-2258

触发单设备访问额度限制，请不要频繁请求

一旦设备达到阈值，当日该设备将不能调用友盟智能认证服务，可根据业务防控需要，切换到其它登录方式 或 禁止当日登录

-2259

触发单设备访问间隔限制，请不要频繁请求

一旦设备达到阈值，当日该设备请求将失败，可根据业务防控需要，切换到其它登录方式 或 禁止当日登录 或 提示用户等待一段时间后再登录

-4001

账号下不存在已激活的有效订单

需要购买订单并激活

-2224

取号失败

请检查手机号是否正确

-2225

验证号码与实际流量号码运营商不一致

请检查手机号是否正确

-2252

执行异常

创建工单反馈，提供返回的requestID

-2253

号码无法判断

请检查手机号是否正确

-2255

query参数appkey不合法，请传输友盟产品控制台分配的appkey，且不要与header中设置的阿里云分配的appkey混淆

请检查appkey是否正确

-2256

query参数appkey不能为空，请传输友盟产品控制台分配的appkey，且不要与header中设置的阿里云分配的appkey混淆

请检查appkey是否正确

-3201

手机号码不应为空

缺少手机号码

-3202

短信模板id不应为空

缺少短信模板id

-3203

vcode不应为空

缺少vcode

-3204

token不应为空

缺少token

-3301

参数填写错误，请检查appkey和模板id是否填写正确

请检查appkey和模板id是否填写正确

-3302

签名或模板校验错误，请检查签名、模板状态是否为审核通过

请检查签名、模板状态是否为审核通过

-3401

Parameter error，deviceId is empty

缺少deviceId

-3402

Parameter error，查询deviceId不能大于100个

查询deviceId不能大于100个

-3403

含有非法的deviceId信息，无法匹配到客户的友盟设备上

请检查deviceId是否正确

-3404

友盟账户不存在

请检查友盟账户是否正确

-3405

Parameter error，查询deviceId不能大于1个

查询deviceId不能大于1个

400、403

-

参考以下步骤进行排查与处理：

1. 查看响应头信息

   打印 response header，重点关注 X-Ca-Error-Message 字段，该字段会返回具体的请求错误原因。

2. 常见问题排查

   • 如果 X-Ca-Error-Message 显示为 "OK"，请检查请求体（request body）中的参数格式是否正确，是否缺失必要参数，或参数值格式不合法。大多数错误来源于参数传递不正确。

   • 确保请求中包含正确的签名、时间戳以及其他认证信息（如适用）。

3. 提交反馈

   若无法通过以上方式定位问题，请打印完整的 response header 信息，并通过提交工单反馈

500

token 被重用或已过期所致

建议您尝试更换一个新的 token 后重新发起请求。如果问题仍未解决创建工单反馈

A400IK

请求地址配置不正确

请确认使用的调用地址是否与产品订购页面中显示的实际地址一致。