# 批量查询技能队列扩展信息 #### 场景描述 批量查询技能队列扩展信息。（该接口CTI3.6版本不支持） #### 接口方法 设置成"POST"。该接口仅支持POST方法，不支持PUT、GET和DELETE等方法。 #### 内部封装接口 BMS接口：/ccbms/ws/monitor/querytotalskillstatusex3 #### 请求URL https://ip:port/rest/cmsapp/v1/openapi/skill/totalskillstatusex3 其中，公有云环境请联系管理员获取，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 | skillIds | array | True | 技能队列ID信息的对象数组。数组长度不大于1000。 技能队列ID取值范围：1～10000。 | #### 响应消息 表3响应消息体参数说明 | 序号 | 名称 | 参数类型 | 说明 | |:---|:---|:---|:---| | 1 | result | String | 查询结果。取值如下： - 0：成功 - 其他：失败 失败的原因说明请参见[错误码参考](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0696.html#ZH-CN_TOPIC_0000002481273824)。 说明： 当前字段为兼容8.13及其之前版本接口响应参数使用。 | | 2 | resultCode | string | 查询结果。取值如下： - "0100000"：成功 - 其他：失败 - 失败的原因说明请参见[错误码参考](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0696.html#ZH-CN_TOPIC_0000002481273824)。 | | 3 | resultDatas | array | 查询成功后，返回结果信息的对象数组。 该数组中对象的参数说明请参见[表4]。 说明： 当前字段为兼容8.13及其之前版本接口响应参数使用。 | | 4 | resultDesc | array | 查询成功后，返回结果信息的对象数组。 该数组对象的参数说明请参见[表4]。 | 表4resultDesc/resultDatas对象参数说明 | 序号 | 名称 | 参数类型 | 说明 | |:---|:---|:---|:---| | 2.1 | skillId | int | 技能队列编号 | | 2.2 | queueSize | int | 当前等待在队列中的呼叫数目 | | 2.3 | queueTime | long | 队列中等待最久的呼叫的等待时间，单位为秒 | | 2.4 | loggedOnAgents | int | 当前签入该技能的座席数量 | | 2.5 | availAgents | int | 该技能队列中当前可用的座席数目 | | 2.6 | skillDescrip | string | 技能描述 | | 2.7 | callId | string | 等待最久的呼叫ID | | 2.8 | maxQueueSize | int | 队列最大可排多少呼叫 如何配置请参见《(For Engineer) ICD VxxxRxxxCxx 产品文档 01 (ICD)》的 **配置排队处理/接通率参数** | #### 样例报文 - 请求头： ``` Content-Type: application/json;charset=UTF-8 Authorization: ****************** ``` - 请求参数： ``` { "ccId":1, "vdn":170, "skillIds":[1,2] } ``` - 响应参数： ``` { "result": "0", "resultCode": "0100000", "resultDatas": [ { "skillId": 1, "queueSize": 0, "loggedOnAgents": 0, "queueTime": 0, "availAgents": 0, "skillDescrip": "defaultVedioSkill", "callId": "4294967295-4294967295", "maxQueueSize": 100 }, { "skillId": 2, "queueSize": 0, "loggedOnAgents": 1, "queueTime": 0, "availAgents": 0, "skillDescrip": "defaultAudioSkill", "callId": "4294967295-4294967295", "maxQueueSize": 100 } ], "resultDesc": [ { "skillId": 1, "queueSize": 0, "loggedOnAgents": 0, "queueTime": 0, "availAgents": 0, "skillDescrip": "defaultVedioSkill", "callId": "4294967295-4294967295", "maxQueueSize": 100 }, { "skillId": 2, "queueSize": 0, "loggedOnAgents": 1, "queueTime": 0, "availAgents": 0, "skillDescrip": "defaultAudioSkill", "callId": "4294967295-4294967295", "maxQueueSize": 100 } ] } ```