
# 查询CTI系统指标接口
#### 前置条件
该接口仅支持全局AK/SK鉴权调用。
注意：本接口仅支持独立部署环境。
#### 场景描述
查询CTI系统指标。
#### 接口方法
设置成"POST"。该接口仅支持POST方法，不支持PUT、GET和DELTE等方法。
#### 请求URL
https://ip:port/rest/cmsapp/v1/openapi/cti/sysindex
其中，公有云环境请联系管理员获取，ip为CC-CMS服务器地址，port为CC-CMS服务器的HTTPS端口号。
非公有云环境如果配置了NSLB服务，ip请填写NSLB的服务器地址，port为CC-CMS服务在NSLB映射的HTTPS端口号。
#### 请求说明
表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请求消息体参数说明 
| 参数名       | 数据类型   | 是否必选  | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| ccId      | int    | False | 呼叫中心编号 - 独立部署环境，默认值为系统管理员登录AICC系统后，通过"配置中心 \> 系统管理 \> 参数配置"查看"默认呼叫中心标识"的值。   |
| vdn       | list   | False | 虚拟呼叫中心编号数组，数组长度最大100                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| beginDate | String | True  | 查询起始时间，零时区时间，开始时间和结束时间间隔不超过31天（取整）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| endDate   | String | True  | 查询结束时间，零时区时间                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| limit     | int    | False | 选填，默认为100                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| offset    | int    | False | 选填，默认为0                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
   
#### 响应消息
表3响应消息体参数说明 
| 参数名        | 数据类型   | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|
| resultCode | string | 查询结果。取值如下： - "0100000"：成功  - 其他：失败  - 失败的原因说明请参见[错误码参考](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0696.html#ZH-CN_TOPIC_0000002481273824)。   |
| resultDesc | List   | 查询成功后，返回结果信息的对象列表。 该数组中对象的参数说明请参见下表。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
   
表4resultDesc对象参数说明 
| 参数名             | 数据类型   | 说明                         |
|:---|:---|:---|
| beginTime       | String | 统计开始时间，毫秒级时间戳(五分钟统计区间开始时间) |
| ccId            | int    | 呼叫中心编号                     |
| vdn             | int    | 虚拟呼叫中心编号                   |
| onlineAgentNums | int    | 在线座席数（包含不接来话的座席数量）         |
| talkingNums     | int    | 通话座席数（不包含不接来话的座席数量）        |
| ideaAgentNum    | int    | 空闲座席数（不包含不接来话的座席数量）        |
| busyNums        | int    | 示忙座席数（不包含不接来话的座席数量）        |
| restNums        | int    | 休息座席数（不包含不接来话的座席数量）        |
| incallNums      | int    | 五分钟内呼入呼叫数                  |
| rateNum         | int    | 五分钟内人工呼入接通数                |
| callRate        | int    | 五分钟内人工呼入接通率                |
| callOutNums     | int    | 五分钟内呼出呼叫数                  |
   
#### 样例报文
- 请求头：
  ```
  Content-Type: application/json;charset=UTF-8
  Authorization: ******************
  ```
  
- 请求参数：
  ```
  {
      "ccId":1,
      "vdn":[1,2,3],
      "beginDate":"2021-09-09 00:00:00",
      "endDate":"2021-09-11 23:00:00",
      "limit":"100",
      "offset":"0"
  }
  ```
  

- 响应参数：
  ```
  {
      "resultCode": 0,
      "resultDesc": {
      "data": [
      {
          "beginTime": "1631594100000",
          "ccId": 1,
          "vdn": 1,
          "onlineAgentNums": 1,
          "talkingNums": 1,
          "ideaAgentNum": 1,
          "busyNums": 1,
          "restNums": 1,
          "inCallNums": 1,
          "rateNum": 1,
          "callRate": 1,
          "callOutNums": 1
      }
      ],
          "count": 6
      }
  }
  ```
  
 
