
# 批量查询技能队列维度服务水平
#### 场景描述
查询当前时刻前5个整分钟起始点所在整5分钟区间的数据。
5个整分钟指往前数5分钟，整5分钟区间指00到05，05到10这种5的倍数区间。
![](https://support.huaweicloud.com/api-ccfs-cec/public_sys-resources/notice_3.0-zh-cn.png)
在was配置台中软参P50配置为1的情况下，callstatinfos呼叫量字段统计时，将不统计无人上班、排队遇忙、排队溢出等不会产生话单的场景。
涉及具体场景：
1. 呼叫路由到技能队列1，技能队列1无座席上班转接到技能队列2，此种场景下，只会生成技能队列2 相关的媒体话单，技能队列1不会生成话单，技能队列1不统计；技能队列2统计；
2. 呼叫路由到技能队列1，技能队列1上排队人数超过最大排队人数（忙转条件配置设备占用率），呼叫从技能队列1转到技能队列2 ，此种场景下，只会生成技能队列2 相关的媒体话单，技能队列1不会生成话单，技能队列1不统计；技能队列2统计；
3. 呼叫路由到技能队列1，技能队列1上预测排队时长超过忙转配置时长（忙转条件配置等待时长），呼叫从技能队列1转到技能队列2 ，此种场景下，只会生成技能队列2 相关的媒体话单，技能队列1不会生成话单，技能队列1不统计；技能队列2统计。
#### 接口方法
设置成"POST"。该接口仅支持POST方法，不支持PUT、GET和DELETE等方法。
#### 内部封装接口
BMS接口：/ccbms/ws/monitor/callStatInfos
#### 请求URL
https://ip:port/rest/cmsapp/v1/openapi/skill/servicequality
其中，公有云环境请联系管理员获取，ip为CC-CMS服务器地址，port为CC-CMS服务器的HTTPS端口号。
非公有云环境如果配置了NSLB服务，ip请填写NSLB的服务器地址，port为CC-CMS服务在NSLB映射的HTTPS端口号。
![](https://support.huaweicloud.com/api-ccfs-cec/public_sys-resources/note_3.0-zh-cn.png)
当前接口性能影响，已添加接口流控限制，每秒仅支持调用一次。
#### 请求说明
表1请求头参数 
| 序号 | 名称            | 参数类型   | 是否必选 | 说明                                                                                                                            |
|:---|:---|:---|:---|:---|
| 1  | Content-Type  | String | True | 固定填 application/json;charset=UTF-8。                                                                                           |
| 2  | Authorization | String | True | 生成方式参见[C2 监控/系统外呼/话单/知识库类接口鉴权方式](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0003.html#ZH-CN_TOPIC_0000002481273406)。 |
   
表2请求消息体参数说明 
| 序号 | 名称       | 参数类型  | 是否必选 | **说明**                                                                                                                                                                                                                                                            |
|:---|:---|:---|:---|:---|
| 1  | ccId     | int   | True | 呼叫中心编号。 取值范围：1～65535                                                                                                                                    |
| 2  | vdn      | int   | True | 虚拟呼叫中心编号。 取值范围：1～5000。                                                                                                                                    |
| 3  | skillIds | array | True | 技能队列ID信息的对象数组。 数组长度不大于1000。 技能队列ID取值范围：1～10000。 |
   
#### 响应消息
表3响应消息体参数说明 
| 序号 | 名称         | 参数类型   | **说明**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| 1  | resultCode | string | 查询结果。取值如下： - "0100000"：成功  - 其他：失败  - 失败的原因说明请参见[错误码参考](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0696.html#ZH-CN_TOPIC_0000002481273824)。   |
| 2  | resultDesc | array  | 查询成功后，返回结果信息的对象数组。 该数组中对象的参数说明请参见[表4]。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
   
 表4resultDesc对象参数说明 
| 序号  | 名称             | 参数类型 | **说明**                    |
|:---|:---|:---|:---|
| 2.1 | skillId        | int  | 技能队列编号。                   |
| 2.2 | statStartTime  | long | 统计的开始时刻。（毫秒级时间戳）          |
| 2.3 | inCallNum      | long | 当前5分钟技能队列的呼入呼叫总和          |
| 2.4 | connectedNum   | long | 当前5分钟技能队列的接通呼叫总和          |
| 2.5 | callLostNum    | long | 当前5分钟技能队列呼损呼叫总和           |
| 2.6 | in15sCallNum   | long | 当前5分钟技能队列内在15S内接通呼叫总和     |
| 2.7 | wait15sLostNum | long | 当前5分钟技能队列排队时长小于15S的呼损呼叫总和 |
| 2.8 | in20sCallNum   | long | 当前5分钟技能队列内在20S内接通呼叫总和     |
| 2.9 | wait20sLostNum | long | 当前5分钟技能队列排队时长小于20S内呼损呼叫总和 |
   
#### 样例报文
- 请求头：
  ```
  Content-Type: application/json;charset=UTF-8
  Authorization: ******************
  ```
  
- 请求参数：
  ```
  {
      "ccId":1, 
      "vdn":1, 
      "skillIds":[1,2]
  }
  ```
  
- 响应参数：
  ```
  {
      "resultCode": "0100000",
      "resultDesc": [
          {
              "in15sCallNum": 0,
              "skillId": 1,
              "wait15sLostNum": 0,
              "callLostNum": 0,
              "in20sCallNum": 0,
              "statStartTime": 1611714900000,
              "wait20sLostNum": 0,
              "inCallNum": 0,
              "connectedNum": 0
          }
      ]
  }
  ```
  
 
