全局错误码和状态码
一、接口异常错误
说明: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 | 被叫挂机 | 挂机方向 |