报表管理(新)

自定义报表数据查询接口

接口地址

POST http(s)://m.icsoc.net/api/v3/dm-core/report/newReport

接口header

key	value	备注
Content-Type	application/json	标识请求参数为json
Authorization	d5156955e2a6ec760f25366f5626b167ac8bfc97	Authorization为token,用于认证,token获取方式参考最下面的附录,不带Bearer

参数说明

字段	类型	是否必填	说明
templateId	Integer	必填	对应报表模板id,示例如下: 模板id 报表 438 坐席工作表现报表 440 呼叫中心话务报表 439 技能组话务报表 441 业务组话务报表
reportType	String	必填	报表类型,对应枚举如下: 枚举值 类型 P1M_DETAIL 月报 P1D_DETAIL 日报 P1W_DETAIL 周报 PT1H_DETAIL 小时明细 PT1H_ADD 小时叠加 PT30M_DETAIL 半小时明细 PT30M_ADD 半小时叠加
startTime	String	必填	开始时间,格式为yyyy-MM-dd HH:mm:ss,日报/周报,格式可为 yyyy-MM-dd,月报,格式可为 yyyy-MM
endTime	String	必填	结束时间,格式为yyyy-MM-dd HH:mm:ss,日报/周报,格式可为 yyyy-MM-dd,月报,格式可为 yyyy-MM

接口参数实例

{
  "templateId": 438,
  "reportType": "P1W_DETAIL",
  "startTime": "2019-04-01 00:00:00",
  "endTime": "2019-04-05 12:00:00"
}

接口返回结果示例:

{
  "code": 0,
  "message": "成功",
  "data": {
    "reportData": [
      {
        "dataDate": "2023-02-05",
        "agName": "test 1245634",
        "CallAnsweredNum_OB": 0
      },
      {
        "dataDate": "2023-02-06",
        "agName": "test 1245634",
        "CallAnsweredNum_OB": 1
      }
    ],
    "provinceData": null,
    "areaDimension": null,
    "columns": [
      {
        "code": "dataDate",
        "title": "时间"
      },
      {
        "code": "agName",
        "title": "坐席工号"
      },
      {
        "code": "CallAnsweredNum_OB",
        "title": "外呼接通量"
      }
    ],
    "dataCount": 2,
    "pageCount": 1
  }
}

结果编码说明

 0 : "成功"
 -1: "开始结束日期最大范围为近一年/开始结束日期最大范围为近一年"
404: "开始日期不能为空"
405: "结束日期不能为空"
406: "开始日期不能大于结束日期"

结果字段说明

字段	类型	说明
code	Integer	0:接口正常返回,-1:调用接口出错
message	String	调用接口成功或异常信息
data	json	报表数据,指标集以模板配置为准(如例子中的CallAnsweredNum_OB)
dataCount	Integer	数据条数
columns	json数组	报表指标编码对应中文解释(指标code和名称)

#参数校验有误返回示例

{
    "code": 0,
    "message": "成功",
    "data": {
        "code": 404,
        "message": "开始日期不能为空"
    }
}

{
    "code": -1,
    "message": "报表模板不存在"
}

{
    "code": 0,
    "message": "成功",
    "data": {
        "code": 405,
        "message": "结束日期不能为空"
    }
}