# 查询坐席状态（API名称：findOnlineAgent）
#### 功能介绍
该接口用于查询当前租户下不同业务类型人员坐席状态。
#### 相关接口
| **接口名称**                                                             | **调用说明**                                                     |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 |
   
#### 调用流程
图1查询坐席状态流程   
![](https://support.huaweicloud.com/api-isdp/zh-cn_image_0000002522854535.png "点击放大")
#### URL
| **请求方式** | **HTTPS地址**                                               | **服务架构** | **消息体类型**        |
|:---|:---|:---|:---|
| POST     | https://***isdp+域名***/openapi/v1/openTask/findOnlineAgent | OpenAPI  | application/json |
   
#### 请求头
| **KEY**       | VALUE                  | 是否必填 | **描述**                                                                                           |
|:---|:---|:---|:---|
| Content-Type  | application/json       | 是    | 无                                                                                                |
| Authorization | bearer ${access_token} | 是    | bearer +" "+[5.2.1](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的access_token的值 |
   
#### 请求参数
| **参数**       | **类型** | **是否必填** | **描述**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| type         | int    | 否        | 坐席业务类型： - 0-安全检查  - 1-质量检查  - 2-巡检检查  - 10-视频通话坐席   |
| onlineStatus | int    | 否        | 在线状态： - 0-离线  - 1-在线                                                                                                                                                                                                                                                                               |
| pageStart    | int    | 否        | 当前页码，从0开始                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| pageSize     | int    | 否        | 每页数量，默认并且最大50条                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
   
#### 响应参数
| **参数**       | **类型** | **描述**                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|
| stateCode    | String | 响应状态码： - 0-成功  - 其他-失败   |
| errorMessage | String | 响应描述                                                                                                                                                                                                                                                                                                                                                                                              |
| result       | Object | 响应结果内容data、分页数据                                                                                                                                                                                                                                                                                                                                                                                   |
   
result出参：
| **参数**      | **类型**         | **描述**     |
|:---|:---|:---|
| pos         | int            | 当前页，从0开始   |
| total_count | int            | 总数量        |
| data        | List\<Object\> | 响应结果内容data |
   
data出参：
| **参数**              | **类型** | **描述**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|
| agentCode           | String | 坐席编码                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| productType         | String | 产品类型                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| deliveryScene       | String | 交付场景                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| businessType        | String | 业务类型                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| agentAccount        | String | 坐席账号                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| agentName           | String | 坐席名称                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| type                | String | 坐席业务类型： - 0-安全检查  - 1-质量检查  - 2-巡检检查  - 10-视频通话坐席   |
| areaName            | String | 区域名称                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| cityId              | String | 城市ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| createName          | String | 创建人名字                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| lastUpdateName      | String | 最后更新人名字                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| agentSignInTime     | long   | 坐席签入时长时间戳                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| agentId             | long   | 坐席ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| tenantId            | long   | 租户ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| userId              | long   | 用户Id                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| createdBy           | long   | 创建人id                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| lastUpdatedBy       | long   | 最后更新人id                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| creationTimestamp   | long   | 创建时间戳                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| lastUpdateTimestamp | long   | 修改时间戳                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| onlineStatus        | Int    | 在线状态                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| isArea              | Int    | 按区域开关                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| capacity            | Int    | 直播间容量                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| agentSignInDate     | long   | 坐席签入时长                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| creationDate        | Date   | 创建时间                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| lastUpdateDate      | Date   | 修改时间                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
   
#### 请求示例
```
{
    "pageSize": 1,
    "pageStart": 0,
    "onlineStatus": 1
}
```
#### 响应示例
```
{
    "stateCode": "0",
    "errorMessage": null,
    "result": {
        "data": [
            {
                "agentCode": "0e626733-07d8-45af-af23-aff287b118b8",
                "productType": null,
                "deliveryScene": null,
                "businessType": null,
                "agentAccount": "111111111",
                "agentName": "111111111",
                "type": "0",
                "areaName": "",
                "appName": "isdp-qc-server",
                "entityName": "agent",
                "cityId": null,
                "createName": "小七",
                "lastUpdateName": "小七",
                "agentId": 17813,
                "tenantId": 886,
                "userId": 307457,
                "createdBy": 277881,
                "lastUpdatedBy": 277881,
                "creationTimestamp": 1616486693402,
                "lastUpdateTimestamp": 1616486693402,
                "onlineStatus": 1,
                "isArea": 0,
                "deleteFlag": 0,
                "capacity": 1,
                "creationDate": "2021-03-23T08:04:54.000+00:00",
                "lastUpdateDate": "2021-03-23T08:05:32.000+00:00",
            }
        ],
        "pos": 0,
        "total_count": 340,
        "entityName": null,
    },
}
```
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。