API错误码
本章节响应码数量较多，建议您使用快捷键Ctrl+F在界面进行搜索，找到您需要的错误码处理建议。
404问题处理
若调用接口时返回了404响应，请检查APP接入地址和访问URI（详见申请资源）是否都填写正确，且拼接成了完整的请求URL，如“https://rtccall.myhuaweicloud.cn:443/rest/httpsessions/click2Call/v2.0”。
错误码处理
调用语音通话相关接口会产生接口调用错误码，响应示例如下：
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"resultcode":"0",
"resultdesc":"Success",
"sessionId":"1202_566_0_20161228102743@callenabler.home1.com"
} resultcode参数处理
参数取值 | 英文描述 | 中文描述 | 处理建议 |
|---|---|---|---|
0 | Success. | 请求成功 | 无需处理。 |
1010001 | Internal system error. | 系统错误。 | 联系华为云客服处理。 |
1010002 | Invalid request. | 非法请求。 | 检查请求携带的参数格式是否都合法。 |
1010003 | Invalid app_key. | 无效的app_key。 | 检查请求携带的app_key是否填写正确，app_key从应用管理页面获取，若填写正确，请在应用管理页面检查请求携带的app_key所属应用状态是否正常。 |
1010006 | Invalid Rest API. | 无效的Rest API。 | 请参照接口文档中的请求方法检查对应接口的请求方法填写是否正确。 |
1010007 | The ativeState of User is not ACTIVATING. | 用户状态未激活。 | 请检查app_key所属的华为云账户是否处于欠费状态，若处于欠费状态，请参考华为云账户充值完成充值，若没有处于欠费状态，请联系华为云客服处理。 |
1010008 | The status of the app_key is unavailable. | app_key被暂停使用。 | 请在应用管理页面检查请求携带的app_key所属应用状态是否正常。 |
1010009 | No more APIs can be invoked. |
|
|
1010010 | The flow control upper limit is reached on the platform. | 平台达到系统流控上限。 | 请稍等一分钟后再试。 |
1010011 | The app is not allowed to access a commercial address. | APP没有访问商用地址的权限。 | 请在应用管理页面检查请求携带的app_key所属应用状态是否正常。 |
1010013 | Time out limit. | 时间超出限制。 | 请确认X-AKSK鉴权时，生成随机数的时间与发送请求时的本地时间不能相差太大（具体差值请与管理员确认）。 |
1010021 | Application unavailable. | 应用不可用。 | 请在应用管理页面检查请求携带的app_key所属应用状态是否正常。 |
1010022 | Invalid verification code. | 验证码不合法。 | 请检查verifyCode参数的填写是否合法。 |
1010023 | Invalid display number. | 固话号码不合法。 | 检查displayNbr和displayCalleeNbr参数的填写是否合法，与号码管理页面的“固话号码”保持一致。若合法，请确认该号码是否已申请并下发。申请号码在号码订购页面申请，号码下发后可在号码管理页面查看。 |
1010024 | Invalid caller number. | 主叫号码不合法。 | 检查callerNbr参数的填写是否合法，若合法，请联系管理员确认。 |
1010028 | The API is not allowed to be invoked. | 此API已禁止调用。 | 请将请求中的version参数改为v2.0并修改其余相关参数，再重新调用该API。 |
1010040 | The app_key is not allowed to invoke the API. | app_key没有调用本API的权限。 | 请联系华为云客服确认该app_key对应的应用是否具有语音通话（语音回呼、语音通知、语音验证码）能力。 |
1012001 | Resource of number is not to be applied. | 资源未申请。 | app_key和业务号码未绑定。 |
1012002 | The template ID is not approved. | 模板ID审核未通过。 | 请在控制台语音模板管理页面确认该模板ID是否已审核通过。 |
1012003 | The template ID does not exist. | 模板ID不存在。 | 请在控制台语音模板管理页面确认该模板ID是否已添加。 |
1012004 | The template ID does not exist. | templateParas的参数个数与模板的变量个数不一致。 | 请检查templateParas携带的变量值个数和templateId对应的模板内容中变量的个数是否一致。 |
1012005 | %s of templateParas does not meet template requirements. | 参数templateParas中的%s不符合模板定义的要求。 | 请检查templateParas携带的变量值格式与长度是否符合templateId对应的模板内容中变量的定义。 |
1012006 | The service number is not applied. | 业务号码未申请。 | 请确认是否申请业务号码。 |
1012012 | Application does not open recording function. | 应用未开启录音功能。 | 请在应用管理页面确认请求携带的app_key是否开启了录音功能。 |
1013001 | Calls exceed the SP limit. | 请求次数超过SP配置上限。 | 请联系华为云客服确认开发者呼叫数量限制。 |
1013002 | Calls exceed the APP limit. | 呼叫数超过APP的阈值，app_key是{}，策略名是{}。 | 请联系华为云客服确认应用呼叫数量限制。 |
1013003 | Calls exceed the display number limit. | 呼叫数超过号码{}的阈值，策略名是{}。 | 请联系华为云客服确认显示号码呼叫数量限制。 注：若是全局呼叫频次策略组，则不返回具体号码。 |
1013004 | Callee in blacklist. | 用户{}在黑名单里面，策略名是{}。 | 请联系华为云客服确认被叫黑名单限制。 |
1013011 | Callee is not on the whitelist. | 被叫用户不在白名单中。 | 请联系华为云客服确认被叫号码白名单限制。 |
1016001 | The record does not exist. | 记录不存在。 | 检查请求携带的callerNbr和app_key是否填写正确。app_key从应用管理页面获取。并确保使用该callerNbr和app_key调用过“语音回呼场景API”。 |
1020001 | Parameter error. | 参数错误。 | 检查请求携带的参数格式是否都合法。 |
1020002 | Internal error. | 内部错误。 | 请联系华为云客服处理。 |
1020003 | Parameter error. | 参数错误。 | 根据API接口文档的参数描述和要求，排查已开发的代码中参数设置是否有效。 |
1020150 | Invalid app_key. | app_key无效。 | 检查请求携带的app_key是否填写正确，app_key从应用管理页面获取，若填写正确，请在应用管理页面检查请求携带的app_key所属应用状态是否正常。 |
1020151 | The bindNum is invalid. | 业务号码无效。 | 业务号码无效，请联系管理员处理。 |
1020152 | Invalid sessionId. | sessionId无效。 | 检查请求携带的sessionId是否填写正确。语音回呼的sessionId是调用“语音回呼场景API”的成功响应消息的sessionId参数值，也可通过呼叫状态和话单通知API获取。 |
1020154 | Insufficient voice ports. | 语音端口不足。 | 请稍等一分钟后再试，并联系华为云客服申请扩容语音端口。 |
1020165 | The number of app_key voice call ports exceeds the upper limit. | 超出app_key语音呼叫端口数限制。 | 请稍等一分钟后再试，并联系华为云客服为该app_key对应的应用申请更多的端口配额。 |
1020166 | The app client ip is not in ip white list. | 对端app IP不在白名单列表中。 | 联系华为云客服检查IP白名单是否配置正确。 |
1020176 | Authentication failed, try again later. | 鉴权失败，稍后重试。 | IP因鉴权失败次数过多导致被拉黑，请30分钟后重试，或联系华为云客服申请放通该IP。 |
1023001 | Internal error. | 内部错误。 | 请联系管理员处理。 |
1023002 | Response timeout. | 响应超时。 | 重新发送一次请求，若依然返回响应超时，请联系华为云客服处理。 |
1023006 | Authorization not contained in the HTTP header. | HTTP消息头未找到Authorization字段。 | 请检查HTTP消息头中是否携带了Authorization字段。 |
1023007 | realm not contained in Authorization. | Authorization字段中未找到realm属性。 | 请检查Authorization字段中的是否携带了realm属性。 |
1023008 | profile not contained in Authorization. | Authorization字段中未找到profile属性。 | 请检查Authorization字段中的是否携带了profile属性。 |
1023009 | The value of realm in Authorization must be SDP. | Authorization中realm属性值应该为“SDP”。 | 请检查Authorization字段中的realm属性值是否为“SDP”。 |
1023010 | The value of profile in Authorization must be UsernameToken. | Authorization中profile属性值应该为“UsernameToken”。 | 请检查Authorization字段中的profile属性值是否为“UsernameToken”。 |
1023011 | The value of type in Authorization must be app_key. | Authorization中type属性值应该为“Appkey”。 | 请检查Authorization字段中的type属性值是否为“Appkey”。 |
1023012 | type not contained in Authorization. | Authorization字段中未找到type属性。 | 请检查Authorization字段中是否携带了type属性。 |
1023033 | HTTP header not found X-AKSK field. | HTTP头未找到X-AKSK字段。 | 请检查HTTP消息头中是否携带了X-AKSK字段。 |
1023034 | UserName not contained in X-AKSK. | X-AKSK字段中未找到UserName属性。 | 请检查X-AKSK字段中的是否携带了Username属性。 |
1023035 | Nonce not contained in X-AKSK. | X-AKSK字段中未找到Nonce属性。 | 请检查X-AKSK字段中的是否携带了Nonce属性。 |
1023036 | Created not contained in X-AKSK. | X-AKSK字段中未找到Created属性。 | 请检查X-AKSK字段中的是否携带了Created属性。 |
1023037 | PasswordDigest not contained in X-AKSK. | X-AKSK字段中未找到PasswordDigest属性。 | 请检查X-AKSK字段中的是否携带了PasswordDigest属性。 |
1023038 | UsernameToken not contained in X-AKSK. | X-AKSK中没有携带UsernameToken。 | 请检查X-AKSK字段中的是否携带了UsernameToken属性。 |
- | - | 获取录音文件下载地址API：成功响应，请从Location头域中获取录音文件下载地址。 |
