
# 查询指定座席详细信息
#### 场景描述
查询指定座席详细信息。
#### 请求方法
设置成"POST"。该接口仅支持POST方法，不支持PUT、GET和DELTE等方法。
#### 内部封装接口
BMS接口：/ccbms/ws/monitor/siteagentinfobyagentids
#### 请求URL
https://ip:port/rest/cmsapp/v1/openapi/agentgroup/agentbyworkno
其中，ip为NSLB的服务器IP地址，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)。 |
   
- 消息头 Content-Type:application/json;charset=UTF-8
  
- 消息体 该接口的请求消息体举例如下：
  ```
  {
      "queryParam":
      {
          "ccId":1, 
          "vdn":1,
          "agentId":101
      }
  }
  ```
  
该接口的请求消息体参数说明请参见[表2](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0632.html#ZH-CN_TOPIC_0000002481273780__zh-cn_topic_0000002478109756_zh-cn_topic_0274247513_table132391613123513)。
表2消息体参数说明 
| 参数名     | 数据类型 | 是否必选 | 说明                                                                                                                              |
|:---|:---|:---|:---|
| ccId    | int  | True | 呼叫中心编号。 取值范围：1～65535  |
| vdn     | int  | True | 虚拟呼叫中心编号。 取值范围：1～5000  |
| agentId | Int  | True | 座席工号。 取值范围：101-59999 |
   
#### 响应消息
该接口的响应消息体举例如下：
```
{
  "result": "0",
  "resultDatas": {
    "workno": 101,
    "vdnid": 1,
    "citStatus": 0,
    "name": "HW35154101",
    "phonenumber": null,
    "logindate": 4294967295000,
    "currentstatetime": 436879,
    "mediatype": 0,
    "status": 2
  }
}
```
该接口的响应消息体参数说明请参见[表3](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0632.html#ZH-CN_TOPIC_0000002481273780__zh-cn_topic_0000002478109756_zh-cn_topic_0274247513_table290410210361)。
表3消息体参数说明 
| 参数名         | 数据类型   | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|
| result      | string | 查询结果。取值如下： - 0：成功  - 非0：失败   失败的原因说明请参见[错误码参考](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0696.html#ZH-CN_TOPIC_0000002481273824)。 |
| resultDatas | object | 查询成功后，返回结果信息的对象。 该对象的参数说明请参见[表4](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0632.html#ZH-CN_TOPIC_0000002481273780__zh-cn_topic_0000002478109756_zh-cn_topic_0274247513_table59318233616)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
   
表4resultDatas对象参数说明 
| 参数名              | 数据类型   | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|
| workno           | int    | 座席工号。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| vdnid            | int    | 所属VDN ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| citStatus        | Int    | 座席平台状态，请参见[CTI平台座席状态码参考](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0697.html#ZH-CN_TOPIC_0000002513073729)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| name             | String | 座席名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| phonenumber      | String | 座席电话号码。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| logindate        | long   | 签入时间。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| currentstatetime | long   | 当前状态时长。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 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)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| status           | Int    | 座席状态。取值： 0：未知。对应CTT平台状态的9 2：签出状态。对应CTT平台状态的0 3：示忙状态。对应CTI平台状态的7 4：空闲状态。对应CTT平台状态的1 5：整理态。对应CTT平台状态的6 7：通话态。对应CTT平台状态的2、3、4、5 8：休息状态。对应CTT平台状态的8 |
   
