查询队列
API接口URL
https://sdk.cloudroom.com/CLOUDMEETING-API/queue/query
请求方式:POST
参数
接口参数
| 名称 | 类型 | 是否必传 | 说明 | |||
|---|---|---|---|---|---|---|
| QueueID | Integer | 否 | 队列ID | |||
| QueueName | String | 否 | 队列名称(全文模糊查询) | |||
| QueDesc | String | 否 | 描述信息 | |||
| PageNumber | Integer | 否 | 分页查询页数,最小值 1 ,默认 1 | |||
| PageSize | Integer | 否 | 分页查询每页数量,最小值 1 最大值 50 ,默认 20 | |||
请求参数示例
{
"RequestId":"95257a6e-dd78-19f9-0c78-3f3de5d35191",
"CompID":111111,
"SecretKey":"08635988d9be4151fcb5251b0af2b3c1",
"AppId":"4026859001",
"QueueID":1035,
"QueueName":"test"
}
返回数据
| 名称 | 类型 | 说明 | ||
|---|---|---|---|---|
| RspCode | String | 响应码 | ||
| RspDesc | String | 响应描述 | ||
| Data | Map | 数据集合 | ||
Data数据
| 名称 | 类型 | 说明 | ||
|---|---|---|---|---|
| queueCount | Integer | 符合条件的队列总数 | ||
| queueList | List | 数据集合(数组) | ||
queueList数据
| 名称 | 类型 | 说明 | ||
|---|---|---|---|---|
| QueueID | Integer | 队列ID | ||
| QueueName | String | 队列名称 | ||
| Priority | Integer | 优先级 | ||
| Global | Integer | 是否全局队列:0 否 1 是 | ||
| QueDesc | String | 描述 | ||
| CreateTime | String | 创建时间 | ||
| UpdateTime | String | 最后修改时间 | ||
| AgentNum | Integer | 坐席数 | ||
| SrvNum | Integer | 正在服务人数 | ||
| WaitNum | Integer | 排队人数 | ||
| PrepareNum | Integer | 准备服务人数 | ||
| MaxWaitNum | Integer | 队列最大长度 | ||
| MaxWaitTime | Integer | 最大等待时间 | ||
返回参数示例
{
"Data": {
"queueCount": 1,
"queueList": [
{
"Priority": 10,
"PrepareNum": 0,
"CreateTime": "2025-05-21 11:27:33",
"QueueID": 1035,
"AgentNum": 0,
"MaxWaitTime": "0秒",
"Global": 0,
"SrvNum": 0,
"WaitNum": 0,
"UpdateTime": "2025-05-21 11:34:56",
"QueueName": "testm",
"QueDesc": "test api",
"MaxWaitNum": 0
}
]
},
"RspCode": 0,
"RspDesc": "请求成功"
}
返回状态码RspCode说明
| 数值 | 说明 | |
|---|---|---|
| 0 | 请求成功 | |
| 1 | 用户所属企业没有接口API权限 | |
| 2 | 账号不存在 | |
| 3 | 密码错误 | |
| 4 | 未获取到正确参数 | |
| 5 | 未知错误 | |