# 全局错误码和状态码

#### 一、接口异常错误

说明：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	| 用户忙	| 挂机原因                         |
| 10007	| 服务器端挂断	| 挂机原因                         |
| 10008	| 分机未注册	| 挂机原因                         |
| 10009	| 目标不可达	| 挂机原因                         |
| 10011	| 定时器超时	| 挂机原因                         |
| 10012	| 呼入时回调接口错误	| 挂机原因                         |
| 10013	| 分机不存在	| 挂机原因                         |
| 10014	| 未发现	| 挂机原因                         |
| 10015	| 请求超时	| 挂机原因                         |
| 10016	| 无人接听	| 挂机原因                         |
| 10017	| 呼叫失效	| 挂机原因                         |
| 10019	| 归属地未知	| 挂机原因                         |
| 10020	| 其它原因	| 挂机原因                         |
| 10024	| 错误请求	| 挂机原因                         |
| 10025	| 呼叫被禁止	| 挂机原因                         |
| 10027	| 号码被改变	| 挂机原因                         |
| 10028	| 呼叫拦截	| 挂机原因                         |
| 10031	| 未知 | 挂机原因                         |
| 10040 | 主叫挂机     | 挂机方向                         |
| 10041 | 被叫挂机     | 挂机方向                         |