# 查询技能队列下已签入座席的详细信息
#### 场景描述
根据技能队列ID，返回该技能队列下已签入座席的详细信息。
![](https://support.huaweicloud.com/api-ccfs-cec/public_sys-resources/note_3.0-zh-cn.png)
超过10000座席时，性能会下降。
#### 接口方法
设置成"POST"。该接口仅支持POST方法，不支持PUT、GET和DELTE等方法。
#### 内部封装接口
BMS接口：/ccbms/ws/monitor/agentstatusinfo
#### 请求URL
https://ip:port/rest/cmsapp/v1/openapi/skill/agentbyconfigedskill
其中，公有云环境请联系管理员获取，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消息体参数说明 
| 序号 | 名称      | 参数类型 | 是否必选 | 说明                                                                                                                        |
|:---|:---|:---|:---|:---|
| 1  | ccId    | int  | True | 呼叫中心编号。 取值范围：1～65535     |
| 2  | vdn     | int  | True | 虚拟呼叫中心编号。 取值范围：1～5000 |
| 3  | skillId | Int  | True | 技能队列编号。 取值范围：1～10000。 |
   
#### 响应消息
表3消息体参数说明 
| 序号 | 名称          | 参数类型   | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| 1  | result      | String | 查询结果。取值如下： - 0：成功  - 其他：失败   失败的原因说明请参见[错误码参考](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0696.html#ZH-CN_TOPIC_0000002481273824)。 说明： 当前字段为兼容8.12及其之前版本接口响应参数使用。 |
| 2  | resultCode  | string | 查询结果。取值如下： - "0100000"：成功  - 其他：失败  - 失败的原因说明请参见[错误码参考](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0696.html#ZH-CN_TOPIC_0000002481273824)。                       |
| 3  | resultDatas | array  | 查询成功后，返回结果信息的对象数组。 该数组中对象的参数说明请参见[表4]。 说明： 当前字段为兼容8.12及其之前版本接口响应参数使用。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| 4  | resultDesc  | array  | 查询成功后，返回结果信息的对象数组。 该数组中对象的参数说明请参见[表4]。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
   
 表4resultDesc/resultDatas对象参数说明 
| 序号   | 名称               | 参数类型   | 说明                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| 2.1  | workNo           | int    | 座席工号。                                                                                                                                                                                                                                   |
| 2.2  | name             | string | 座席名称。                                                                                                                                                                                                                                   |
| 2.3  | status           | int    | 座席状态，参数说明请参考[表5]。                                                                                                                |
| 2.4  | ctiStatus        | int    | 座席平台状态，参数说明请参考[CTI平台座席状态码参考](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0697.html#ZH-CN_TOPIC_0000002513073729)                                                                                                                |
| 2.5  | groupId          | int    | 座席班组ID。                                                                                                                                                                                                                                 |
| 2.6  | mediaType        | int    | 座席媒体类型，请参见[表1](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0698.html#ZH-CN_TOPIC_0000002513233715__zh-cn_topic_0000002510109741_zh-cn_topic_0000001843009401_zh-cn_topic_0000001451970565_zh-cn_topic_0240433933_table13565990) |
| 2.7  | vdnId            | int    | 所属VDN ID。                                                                                                                                                                                                                               |
| 2.8  | phoneNumber      | string | 座席电话号码。                                                                                                                                                                                                                                 |
| 2.9  | currentStateTime | long   | 当前状态时长。(秒)                                                                                                                                                                                                                              |
| 2.10 | loginDate        | long   | 签入时间。（毫秒级时间戳）                                                                                                                                                                                                                           |
   
 表5座席状态 
| 值 | 说明                     |
|:--|:---|
| 0 | 未知。对应CTI平台状态的9。        |
| 2 | 表示调用该接口出现异常。           |
| 3 | 示忙状态。对应CTI平台状态的7。      |
| 4 | 空闲状态。对应CTI平台状态的1。      |
| 5 | 整理态。对应CTI平台状态的6。       |
| 7 | 通话态。对应CTI平台状态的2、3、4、5。 |
| 8 | 休息状态。对应CTI平台状态的8。      |
   
#### 样例报文
- 请求头：
  ```
  Content-Type: application/json;charset=UTF-8
  Authorization: ******************
  ```
  
- 请求参数：
  ```
  {
      "queryParam":
      {
          "ccId":1, 
          "vdn":1,
          "skillId":1
      }
  }
  ```
  
- 请求参数：
  ```
  {
      "result": "0",
      "resultCode": "0100000",
      "resultDatas": [
          {
              "workNo": 20011,
              "name": "20011",
              "status": 4,
              "ctiStatus": 1,
              "groupId": 1,
              "mediaType": 1,
              "vdnId": 1,
              "phoneNumber": "70942",
              "currentStateTime": 1505,
              "loginDate": 1501125758000
          }
      ],
      "resultDesc": [
          {
              "workNo": 20011,
              "name": "20011",
              "status": 4,
              "ctiStatus": 1,
              "groupId": 1,
              "mediaType": 1,
              "vdnId": 1,
              "phoneNumber": "70942",
              "currentStateTime": 1505,
              "loginDate": 1501125758000
          }
      ]
  }
  ```