通用API- 全局错误码和状态码
全局错误码和状态码
一、接口异常错误
说明：ret为非200，msg为异常的错误信息。
{
"ret":400, // 状态码
"data":[],
"msg":"非法请求：参数不合法"
}
| ret |
msg |
说明 |
| 400 |
非法请求 |
一般为参数不合法 |
| 500 |
|
服务器错误 |
| 600 |
|
token无效请重新登陆验证 |
| 601 |
appid未授权 |
请检查appid或联系云呼科技是否授权 |
| 602 |
|
appid授权已到期 |
| 603 |
|
模块未授权 |
| 604 |
IP未授权 |
请联系厂商授权访问 |
二、接口请求正常,内部处理错误
说明：ret为200。data结构体里status为1，desc为失败的中文描述，errors为详细错误信息，其中code码请参照对应说明。msg为空。
{
"ret": 200,
"data": {
"status": 1,
"desc": "xxx失败",
"errors": {
"code": "1003",
"codemsg": "授权失败"
},
"reqtime": 1507529858,
"rsptime": 1507529858
},
"msg": ""
}
| code |
codemsg |
说明 |
| 1001 |
服务器连接失败 |
一般为网络原因 |
| 1002 |
操作异常 |
一般为校验异常等 |
| 1003 |
操作失败 |
一般是授权失败、注销失败、命令发送失败、服务器连接异常等 |
| 1010 |
分机异常 |
可能是新加的分机，需要重新登陆获取新token |
| 1011 |
非法分机 |
非本公司所有 |
| 1012 |
分机不存在 |
分机号码状态 |
| 1013 |
分机已停用 |
分机号码状态 |
| 1014 |
分机未注册 |
分机号码状态 |
| 1015 |
分机不在通话中 |
分机号码状态 |
| 1016 |
分机已启用 |
分机号码状态 |
| 1017 |
分机已注册 |
分机号码状态 |
| 1018 |
号码已启用 |
主叫号码状态 |
| 1019 |
号码已禁用 |
主叫号码状态 |
| 1020 |
号码不存在 |
主叫号码状态 |
| 1021 |
非法号码 |
非本公司所有 |
| 1024 |
任务不存在 |
预测式任务接口返回状态 |
| 1025 |
未开始 |
预测式任务接口返回状态 |
| 1026 |
进行中 |
预测式任务接口返回状态 |
| 1027 |
暂停 |
预测式任务接口返回状态 |
| 1028 |
已结束 |
预测式任务接口返回状态 |
| 1201 |
空闲 |
分机合法、已启用并已注册 |
| 1202 |
振铃 |
分机号返回 |
| 1203 |
摘机 |
分机号返回 |
| 1204 |
通话中 |
分机号返回 |
| 1205 |
用户拒接 |
被叫方拒接 |
| 1210 |
队列异常 |
预测式外呼中返回 |
| 1211 |
非法队列 |
不存在或非本公司所有 |
| 1212 |
未接听 |
已分配未接听 |
| 1213 |
等待中 |
等待分配(示闲) |
| 1214 |
接收中 |
队列中的分机状态 |
| 1215 |
已接听 |
队列里的分机状态 |
| 1216 |
拒接 |
队列里的分机状态 |
| 1217 |
暂停 |
示忙 |
| 1218 |
已签入 |
队列中已签入该分机 |
| 10001 |
正常挂断 |
呼叫状态 |
| 10002 |
呼叫取消 |
呼叫状态 |
| 10003 |
拒绝接听 |
呼叫状态 |
| 10004 |
外呼通道线路失败 |
一般为线路原因 |
| 10005 |
用户超时未接听 |
呼叫状态 |
| 10006 |
用户忙 |
呼叫状态 |
| 10040 |
主叫挂机 |
呼叫状态 |
| 10041 |
被叫挂机 |
呼叫状态 |
