API错误码处理
本章节响应码数量较多，建议您使用快捷键Ctrl+F在界面进行搜索，能更快的找到您需要的错误码处理建议。
接口调用404问题处理
若调用接口时返回了404响应，请检查APP接入地址和访问URI（详见API参考文档）是否都填写正确，且拼接成了完整的请求URL，如“https://rtcpns.cn-north-1.myhuaweicloud.com/rest/provision/caas/privatenumber/v1.0”。
接口调用错误码处理
调用API接口会产生接口调用响应结果码，响应示例如下：
注：请根据响应码和结果码查看处理方法。
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
Content-Length: xx
{
"resultcode":"0",
"resultdesc":"Success",
"origNum":"+86138****8888",
"privateNum":"+86138****6666",
"subscriptionId":"******"
}
|
响应码 |
结果码 |
英文描述 |
中文描述 |
处理方法 |
|---|---|---|---|---|
|
200 |
0 |
Success. |
成功。 |
- |
|
400 |
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-AKAK. |
X-AKAK字段中未找到Nonce属性。 |
请检查X-AKAK字段中的是否携带了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属性。 |
|
|
401 |
1010010 |
Invalid digest. |
PasswordDigest校验失败。 |
请检查PasswordDigest字段填写是否正确。 |
|
1010013 |
Time out limit. |
时间超出限制。 |
请确认X-AKSK鉴权时，生成随机数的时间与发送请求时的本地时间不能相差太大（具体差值请与管理员确认）。 |
|
|
403 |
1010002 |
Invalid request. |
无效请求。 |
参考各接口参数说明，检查请求携带的参数格式是否正确，如以下参数格式问题：
|
|
1010003 |
Invalid app_key. |
无效的app_key。 |
请检查请求携带的app_key填写是否正确。 |
|
|
1010008 |
The status of the app_key is unavailable. |
app_key状态异常。 |
请检查请求携带的app_key所属应用状态是否正常。应用状态可登录控制台后在“应用管理”界面查看。 |
|
|
1010010 |
The flow control upper limit is reached on the platform. |
平台达到系统流控上限。 |
请稍等一分钟后再试。 |
|
|
1010029 |
The subscriber status is frozen. |
用户账号已冻结。 |
查看账户是否欠费。
|
|
|
1010040 |
The app_key is not allowed to invoke the API. |
app_key没有调用本API的权限。 |
出现该错误码表示调用的接口和app_key所属的应用模式不一致。如添加应用时选择的AXB模式的应用，调用接口时只能调用AXB模式的接口，不能调用其他模式的接口。 |
|
|
1016002 |
The record already exists. |
记录已经存在。 |
出现该错误码表示调用AX模式绑定接口时指定的A号码（origNum）和X号码（privateNum）之间已经存在绑定关系，请更换origNum或privateNum参数的值。 |
|
|
1011001 |
Account does not exist. |
账号不存在。 |
出现该错误码可能有以下两个原因： |
|
|
1011002 |
Insufficient number resources. |
号码资源不足。 |
出现该错误码表示调用AX模式绑定接口时没有可分配的X号码，请申请新的号码资源或修改areaCode的值。点击查看处理方法 |
|
|
1011003 |
Exceeded the upper limit of resources that can be applied for. |
超过允许申请的资源上限。 |
出现该错误码表示调用AX模式绑定接口时指定的A号码已绑定了五个X号码，请更换origNum参数的值。AX模式中一个A号码只能绑定五个X号码。 |
|
|
1011004 |
The number is not applied for binding application. |
携带的X号码和app_key没有绑定关系。 |
出现该错误码表示调用AX模式解绑接口或AX模式绑定信息修改接口时携带的app_key和X号码没有绑定关系，请检查携带的X号码是否属于该应用。 |
|
|
1012001 |
Resource of number is not to be applied. |
资源未申请。 |
出现该错误码表示调用解绑或查询绑定关系接口时携带的app_key和X号码没有绑定关系，请检查携带的X号码是否属于该应用。 |
|
|
1012007 |
The record does not exist. |
记录不存在。 |
|
|
|
1012008 |
Insufficient number of resources. |
号码资源不足。 |
没有可分配的X号码，请申请新的号码资源或修改areaCode的值。点击查看处理方法 |
|
|
1012009 |
Maximum number of resources has been exceeded. |
指定的X号码的绑定数量已达到上限。 |
出现该错误码表示调用AXB模式绑定接口指定的X号码已经绑定了5000对关系。请修改relationNum的值，或者解除指定的X号码上的部分绑定关系。AXB模式中一个X号码只能同时绑定5000对关系。 |
|
|
1012010 |
The relation number has been bound. |
绑定关系已存在。 |
出现该错误码表示调用AXB模式绑定接口时携带的X号码（relationNum）和A号码（callerNum）或B号码（calleeNum）已存在绑定关系，可确认后更换其他X号码进行绑定。 |
|
|
1012012 |
Application does not open recording function. |
应用未开启录音功能。 |
出现该错误码表示添加应用时未开启录音功能，点击查看如何开启录音功能。 |
|
|
1012102 |
The number status is abnormal. |
号码状态异常。 |
出现该错误码表示调用接口时指定的X号码因投诉或号码状态异常被隐私保护通话平台加入了黑名单。 请查看订购号码时填写的邮箱是否有业务下线通知邮件，如果没有，请拨打400电话联系华为云客服处理。 |
|
|
1011005 |
Resources have been allocated. |
资源已经分配。 |
出现该错误码表示调用AX模式绑定接口时指定的X号码（privateNum）已和其他A号码绑定，可更换其他X号码进行绑定。 如果该X号码的绑定关系可以解除，您还可以调用AX模式解绑接口解除该绑定关系后，再使用该X号码进行绑定。 |
|
|
1016001 |
The record does not exist. |
记录不存在。 |
|
|
|
1023005 |
Virtual number over license limit. |
隐私号码超出license限制。 |
请联系客服处理。 |
|
|
1020166 |
The app client ip is not in ip white list. |
对端app IP不在白名单列表中。 |
联系客服检查IP白名单是否配置正确。 |
|
|
1020167 |
No idle extend Number. |
没有空闲的分机号。 |
出现该错误码表示调用AXE模式绑定接口时指定的分机号（extendNum）已被占用，请重新指定分机号。 |
|
|
1013102 |
The extend number has been bound. |
绑定关系已存在。 |
出现该错误码表示调用AXE模式绑定接口时指定的X号码（virtualNum）和A号码（bindNum）已有绑定关系，无需再次绑定。 |
|
|
500 |
1010001 |
Internal system error. |
系统错误。 |
请联系客服处理。 |
