# 单个修改技能队列（modifySkill）
#### 场景描述
单个修改技能队列
#### 接口方法
POST
#### 接口URI
https://域名/apiaccess/rest/cc-management/v1/skill/modifySkill，例如域名是service.besclouds.com
#### 请求说明
表1请求头参数 
| 序号 | 名称            | 参数类型   | 是否必选  | 说明                                                         |
|:---|:---|:---|:---|:---|
| 1  | X-APP-KEY     | string | False | appKey字段，用户标识，请联系运营人员获取appKey                              |
| 2  | Authorization | string | True  | 鉴权信息，值为Bearer + tokenByAKSK接口的返回值中的AccessToken（Bearer后有空格） |
   
表2请求体参数 
| 序号      | 名称                 | 参数类型    | 是否必选  | 说明                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|:---|
| 1.1     | description        | string  | False | 技能简称或描述，不超过50个字符（允许的字符包括中文、字母、数字）                                                                                                                                                                                                                                   |
| 1.2     | maxWaitTime        | number  | False | 最大排队等待时间，单位秒，最大值60000                                                                                                                                                                                                                                               |
| 1.3     | maxWaitNum         | number  | False | 最大排队等待人数，最大值10000                                                                                                                                                                                                                                                   |
| 1.4     | maxAgentWrapupTime | number  | False | 整理态时长，单位秒，最大值3600                                                                                                                                                                                                                                                   |
| 1.5     | skillParam         | object  | False | 技能队列参数信息，媒体类型为53或2或18时，只有noAgents、busy和timeOut三项配置，媒体类型为53时deviceType的值只能为1；媒体类型为5或19时noAgents、busy、timeOut、answerFunction和waitVoice配置必填                                                                                                                            |
| 1.5.1   | noAgents           | object  | True  | 无人上班配置                                                                                                                                                                                                                                                              |
| 1.5.1.1 | deviceType         | string  | False | 设备类型。 3：IVR 1：技能队列                                  |
| 1.5.1.2 | transferType       | string  | True  | 处理策略。 Release：释放，此时同级其他参数不填 Transfer：转接，此时同级其他参数必填 |
| 1.5.1.3 | value              | number  | False | 技能队列时取skillId，IVR时取IVR流程编号id                                                                                                                                                                                                                                        |
| 1.5.2   | busy               | object  | True  | 排队遇忙、溢出配置                                                                                                                                                                                                                                                           |
| 1.5.2.1 | deviceType         | string  | False | 设备类型 3：IVR 1：技能队列                                 |
| 1.5.2.2 | transferType       | string  | True  | 处理策略。 Release：释放，此时同级其他参数不填 Transfer：转接，此时同级其他参数必填  |
| 1.5.2.3 | value              | number  | False | 技能队列时取skillId，IVR时取IVR流程编号id                                                                                                                                                                                                                                        |
| 1.5.3   | answerFunction     | string  | False | 业务代表应答方式配置，0报工号2不报语音                                                                                                                                                                                                                                                |
| 1.5.4   | timeOut            | object  | True  | 排队超时配置                                                                                                                                                                                                                                                              |
| 1.5.4.1 | deviceType         | string  | False | 设备类型 3：IVR 1：技能队列                               |
| 1.5.4.2 | transferType       | string  | True  | 处理策略。 Release：释放，此时同级其他参数不填 Transfer：转接，此时同级其他参数必填   |
| 1.5.4.3 | value              | number  | False | 技能队列时取skillId，IVR时取IVR流程编号id                                                                                                                                                                                                                                        |
| 1.5.5   | waitVoice          | object  | False | 排队等待配置                                                                                                                                                                                                                                                              |
| 1.5.5.1 | parameterType      | string  | True  | Voice：Voice，此时同级其他参数不填 IVR：IVR，此时同级其他参数必填                                                                                                                 |
| 1.5.5.2 | id                 | string  | False | IVR时取IVR流程编号id                                                                                                                                                                                                                                                      |
| 1.6     | skillId            | integer | True  | 技能队列ID                                                                                                                                                                                                                                                              |
| 1.7     | name               | string  | False | 技能队列名称                                                                                                                                                                                                                                                              |
   
#### 响应说明
- **响应状态码: 200**
  表3响应体参数 
  | 序号  | 名称          | 参数类型   | 是否必选  | 说明              |
  |:---|:---|:---|:---|:---|
  | 1.1 | returnCode  | string | False | 操作结果。0：成功，非0为失败 |
  | 1.2 | description | string | False | 提示信息            |
     
  
- **响应状态码: 401**
  鉴权失败
  
- **响应状态码: 404**
  请求资源不存在
  
- **响应状态码: 500**
  服务器内部异常
  
 
#### 错误码
无。
#### 报文样例
请求头:
```
Content-Type:application/json
X-APP-KEY:XXXXXXXXXXXXXXXXXXXXXXX
Authorization:Bearer XXXXXXXXXXXXXXXXXXXXXXX
```
请求参数:
```
{
    "skillId": 3,
    "description": "2021ok",
    "maxWaitTime": 60
}
```
响应参数:
```
{
    "returnCode": "0",
    "description": "Update Skill successfully"
}
```