
# API错误码
![](https://support.huaweicloud.com/devg-VoiceCall/public_sys-resources/note_3.0-zh-cn.png)
本章节响应码数量较多，建议您使用快捷键**Ctrl+F**在界面进行搜索，找到您需要的错误码处理建议。
#### 404问题处理
若调用接口时返回了404响应，请检查APP接入地址和访问URI（详见[申请资源](https://support.huaweicloud.com/devg-VoiceCall/rtc_04_0004.html)）是否都填写正确，且拼接成了完整的请求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从[应用管理](https://console.huaweicloud.com/voicecall/#/appManagement)页面获取，若填写正确，请在[应用管理](https://console.huaweicloud.com/voicecall/#/appManagement)页面检查请求携带的app_key所属应用状态是否正常。                                                                                                                                                           |
| 1010006 | Invalid Rest API.                                               | 无效的Rest API。                                                                                                                                                                                                                                             | 请参照[接口文档](https://support.huaweicloud.com/api-VoiceCall/rtc_05_0006.html)中的请求方法检查对应接口的请求方法填写是否正确。                                                                                                                                                                                                                                                                 |
| 1010007 | The ativeState of User is not ACTIVATING.                       | 用户状态未激活。                                                                                                                                                                                                                                                 | 请检查app_key所属的华为云账户是否处于欠费状态，若处于欠费状态，请参考[华为云账户充值](https://support.huaweicloud.com/usermanual-billing/bills-topic_30000002.html)完成充值，若没有处于欠费状态，请联系华为云客服处理。                                                                                                                                                                                                           |
| 1010008 | The status of the app_key is unavailable.                       | app_key被暂停使用。                                                                                                                                                                                                                                            | 请在[应用管理](https://console.huaweicloud.com/voicecall/#/appManagement)页面检查请求携带的app_key所属应用状态是否正常。                                                                                                                                                                                                                                                                    |
| 1010009 | No more APIs can be invoked.                                    | - 刷新授权API：app_secret无效。  - 其他API：API达到调用上限。   | - 刷新授权API：输入正确的app_secret，app_secret从"[应用管理](https://console.huaweicloud.com/voicecall/#/appManagement)"页面获取。  - 其他API：请稍等一分钟后再试，并联系华为云客服申请更高的应用使用配额。   |
| 1010010 | The flow control upper limit is reached on the platform.        | 平台达到系统流控上限。                                                                                                                                                                                                                                              | 请稍等一分钟后再试。                                                                                                                                                                                                                                                                                                                                                        |
| 1010011 | The app is not allowed to access a commercial address.          | APP没有访问商用地址的权限。                                                                                                                                                                                                                                          | 请在[应用管理](https://console.huaweicloud.com/voicecall/#/appManagement)页面检查请求携带的app_key所属应用状态是否正常。                                                                                                                                                                                                                                                                    |
| 1010013 | Time out limit.                                                 | 时间超出限制。                                                                                                                                                                                                                                                  | 请确认X-AKSK鉴权时，生成随机数的时间与发送请求时的本地时间不能相差太大（具体差值请与管理员确认）。                                                                                                                                                                                                                                                                                                              |
| 1010021 | Application unavailable.                                        | 应用不可用。                                                                                                                                                                                                                                                   | 请在[应用管理](https://console.huaweicloud.com/voicecall/#/appManagement)页面检查请求携带的app_key所属应用状态是否正常。                                                                                                                                                                                                                                                                    |
| 1010022 | Invalid verification code.                                      | 验证码不合法。                                                                                                                                                                                                                                                  | 请检查verifyCode参数的填写是否合法。                                                                                                                                                                                                                                                                                                                                           |
| 1010023 | Invalid display number.                                         | 固话号码不合法。                                                                                                                                                                                                                                                 | 检查displayNbr和displayCalleeNbr参数的填写是否合法，与[号码管理](https://console.huaweicloud.com/voicecall/#/numberManagement)页面的"固话号码"保持一致。若合法，请确认该号码是否已申请并下发。申请号码在[号码订购](https://console.huaweicloud.com/voicecall/#/numberOrder)页面申请，号码下发后可在[号码管理](https://console.huaweicloud.com/voicecall/#/numberManagement)页面查看。                                                            |
| 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审核未通过。                                                                                                                                                                                                                                               | 请在控制台[语音模板管理](https://console.huaweicloud.com/voicecall/#/modelManagement)页面确认该模板ID是否已审核通过。                                                                                                                                                                                                                                                                       |
| 1012003 | The template ID does not exist.                                 | 模板ID不存在。                                                                                                                                                                                                                                                 | 请在控制台[语音模板管理](https://console.huaweicloud.com/voicecall/#/modelManagement)页面确认该模板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.                   | 应用未开启录音功能。                                                                                                                                                                                                                                               | 请在[应用管理](https://console.huaweicloud.com/voicecall/#/appManagement)页面确认请求携带的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从[应用管理](https://console.huaweicloud.com/voicecall/#/appManagement)页面获取。并确保使用该callerNbr和app_key调用过"语音回呼场景API"。                                                                                                                                                                                                               |
| 1020001 | Parameter error.                                                | 参数错误。                                                                                                                                                                                                                                                    | 检查请求携带的参数格式是否都合法。                                                                                                                                                                                                                                                                                                                                                 |
| 1020002 | Internal error.                                                 | 内部错误。                                                                                                                                                                                                                                                    | 请联系华为云客服处理。                                                                                                                                                                                                                                                                                                                                                       |
| 1020003 | Parameter error.                                                | 参数错误。                                                                                                                                                                                                                                                    | 根据API接口文档的参数描述和要求，排查已开发的代码中参数设置是否有效。                                                                                                                                                                                                                                                                                                                              |
| 1020150 | Invalid app_key.                                                | app_key无效。                                                                                                                                                                                                                                               | 检查请求携带的app_key是否填写正确，app_key从[应用管理](https://console.huaweicloud.com/voicecall/#/appManagement)页面获取，若填写正确，请在[应用管理](https://console.huaweicloud.com/voicecall/#/appManagement)页面检查请求携带的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头域中获取录音文件下载地址。                                                                                                                                                                                                                                                                                                                       |
   
