
# 手机接听（login）
#### 场景描述
手机接听（离线座席），当某座席因某些原因无法在pc端的座席工作台接听客户电话时，该座席可通过设置"手机接听"来绑定座席电话，实现客户打电话能在手机端接听的功能（支持真实可用的号码，比如手机号、座机号）。
#### 接口方法
POST
#### 接口URI
https://域名/apiaccess/rest/cc-management/v1/offline/agent/login
#### 请求说明
表1请求头参数 
| 序号 | 名称            | 参数类型   | 是否必选  | 说明                                                         |
|:---|:---|:---|:---|:---|
| 1  | X-APP-KEY     | string | False | appKey字段，用户标识，请联系运营人员获取appKey                              |
| 2  | Authorization | string | True  | 鉴权信息，值为Bearer + tokenByAKSK接口的返回值中的AccessToken（Bearer后有空格） |
   
表2请求体参数 
| 序号  | 名称     | 参数类型   | 是否必选 | 说明                         |
|:---|:---|:---|:---|:---|
| 1.1 | phone  | string | True | 进行接听的号码（真实可用的号码，比如手机号、座机号） |
| 1.2 | workNo | number | True | 座席工号                       |
   
#### 响应说明
- **响应状态码: 200**
  表3响应体参数 
  | 序号     | 名称                    | 参数类型            | 是否必选  | 说明                                         |
  |:---|:---|:---|:---|:---|
  | 1.1    | returnCode            | string          | True  | 操作结果。0：成功，非0为失败                            |
  | 1.2    | description           | string          | False | 提示信息                                       |
  | 1.3    | restTime              | string          | False | 休息时长，单位秒                                   |
  | 1.4    | agentType             | string          | False | 座席类型（4：音频座席，5：多媒体座席，11：视频座席，99：全能型座席）      |
  | 1.5    | forceLogin            | boolean         | False | 是否强制签入（true：是，false：否）                     |
  | 1.6    | isAutoAnswer          | string          | False | 是否自动应答（true：是，false：否）                     |
  | 1.7    | videoMode             | number          | False | 视频应用模式（0：SFU视频，1：MCU视频，2：SFU+MCU视频）        |
  | 1.8    | workNo                | number          | False | 座席工号                                       |
  | 1.9    | isMultiChannelSupport | boolean         | False | 是否多渠道签入（true：是，false：否）                    |
  | 1.10   | skills                | array\[object\] | False | 技能队列列表                                     |
  | 1.10.1 | skillId               | number          | False | 技能队列ID                                     |
  | 1.10.2 | mediaTypeId           | string          | False | 媒体类型（5：语音；53：多媒体；19：视频；2：语音点击通话；18：视频点击通话） |
     
  
- **响应状态码: 401**
  鉴权失败
  
- **响应状态码: 404**
  请求资源不存在
  
- **响应状态码: 500**
  服务器内部异常
  
 
#### 错误码
无。
#### 报文样例
请求头:
```
Content-Type:application/json
X-APP-KEY:*********************
Authorization:Bearer *********************
```
请求参数:
```
{"phone":"13800000000","workNo":107}
```
响应参数:
```
{
    "restTime": "",
    "agentType": "4",
    "forceLogin": true,
    "isAutoAnswer": "true",
    "description": "success",
    "videoMode": 0,
    "workNo": 107,
    "skills": [
        {
            "skillId": 4,
            "mediaTypeId": "5"
        }
    ],
    "returnCode": "0",
    "isMultiChannelSupport": false
}
```
