获取技能维度的历史监控指标
场景描述
获取技能维度的历史监控指标。
接口方法
设置成“POST”。该接口仅支持POST方法,不支持PUT、GET和DELETE等方法。
请求URL
https://ip:port/rest/cmsapp/v1/openapi/hisindex/skill
其中,公有云环境请联系管理员获取,ip为CC-CMS服务器地址,port为CC-CMS服务器的HTTPS端口号。
非公有云环境如果配置了NSLB服务,ip请填写NSLB的服务器地址,port为CC-CMS服务在NSLB映射的HTTPS端口号。
请求说明
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
1 |
Content-Type |
String |
True |
固定填 application/json; charset=UTF-8。 |
2 |
Authorization |
String |
True |
生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 |
参数名 |
数据类型 |
是否必选 |
说明 |
---|---|---|---|
ccId |
int |
False |
呼叫中心编号,取值范围:1~65535。
|
vdn |
int |
True |
虚拟呼叫中心编号,取值范围:1~5000。 |
timeGrain |
String |
False |
该入参可按分钟粒度进行历史监控指标统计,可选值为("15MIN","30MIN","60MIN"),如果不传则统计当天(VDN所在时区)数据。 |
skillIds |
List<Integer> |
True |
技能队列编号的数组,数组长度最大1000。技能队列为int型。 |
indexIds |
List<String> |
True |
指标的数组。指标为String型。数组最大长度为技能历史监控指标的个数。 具体指标请参见表1 |
mediaType |
int |
False |
呼叫媒体类型,具体请参见表1。 |
subMediaType |
int |
False |
子媒体类型,具体请参见表3。 |
enableOffset |
String |
False |
可选值为("Y","N"),传"Y"则查询前一天的数据,传"N"则查询当天的数据,不传默认为"N"。 |
响应消息
参数名 |
数据类型 |
说明 |
---|---|---|
result |
String |
查询结果。取值如下:
失败的原因说明请参见错误码参考。
说明:
当前字段为兼容8.13及其之前版本接口响应参数使用。 |
resultCode |
String |
查询结果。取值如下:
失败的原因说明请参见错误码参考。 |
resultDatas |
List< JSONObject> |
查询成功后,返回结果信息的对象数组。 该数组中对象的参数说明请参见表4。
说明:
当前字段为兼容8.13及其之前版本接口响应参数使用。 |
resultDesc |
List< JSONObject> |
查询成功后,返回结果信息的对象数组。 该数组中对象的参数说明请参见表4。 |
参数名 |
数据类型 |
说明 |
---|---|---|
id |
String |
技能队列编号。 |
idxs |
List< JSONObject> |
指标结果集。 该对象的参数说明请参见表1。 |
参数名 |
数据类型 |
说明 |
---|---|---|
id |
String |
指标ID。 |
val |
Object |
按分钟粒度统计的指标结果,时间为零时区时间。 参数格式为"时间":"指标结果",表示当前时间起一段时间间隔中统计的指标结果数量,时间间隔长度由请求参数中的timeGrain参数决定。 例如"2020-11-11 09:15:00.0": "1",表示09:15~09:30时指标结果为1,此时请求参数中timeGrain的值为15。 |
样例报文
- 请求头:
Content-Type: application/json;charset=UTF-8 Authorization: ******************
- 请求参数:
{ "ccId":1, "vdn":1, "skillIds":[11,24], "timeGrain":"15MIN", "indexIds":["IDX_COUNT_SKILL_REQUEST","IDX_COUNT_SKILL_CONNECTED"], "mediaType":53, "subMediaType":3 }
- 响应参数:
{ "result": "0", "resultCode": "0100000", "resultDatas": [ { "idxs": [ { "val": { "2020-08-24 10:30:00.0": "15", "2020-08-24 10:45:00.0": "19" }, "id": "IDX_COUNT_SKILL_REQUEST" }, { "val": { "2020-08-24 10:30:00.0": "6", "2020-08-24 10:45:00.0": "4" }, "id": "IDX_COUNT_SKILL_CONNECTED" } ], "id": "12" }, { "idxs": [ { "val": { "2020-08-24 10:00:00.0": "16", "2020-08-24 10:15:00.0": "14" }, "id": "IDX_COUNT_SKILL_REQUEST" }, { "val": { "2020-08-24 10:00:00.0": "5", "2020-08-24 10:15:00.0": "4" }, "id": "IDX_COUNT_SKILL_CONNECTED" } ], "id": "13" } ], "resultDesc": [ { "idxs": [ { "val": { "2020-08-24 10:30:00.0": "15", "2020-08-24 10:45:00.0": "19" }, "id": "IDX_COUNT_SKILL_REQUEST" }, { "val": { "2020-08-24 10:30:00.0": "6", "2020-08-24 10:45:00.0": "4" }, "id": "IDX_COUNT_SKILL_CONNECTED" } ], "id": "12" }, { "idxs": [ { "val": { "2020-08-24 10:00:00.0": "16", "2020-08-24 10:15:00.0": "14" }, "id": "IDX_COUNT_SKILL_REQUEST" }, { "val": { "2020-08-24 10:00:00.0": "5", "2020-08-24 10:15:00.0": "4" }, "id": "IDX_COUNT_SKILL_CONNECTED" } ], "id": "13" } ] }