查询工单总览统计

描述

按照条件查询工单总览统计，支持按照起止时间过滤查询结果，并按时间倒序查询。分页查询默认最大分页100条数据。

接口方法

POST

接口URI

https://域名/AICC__Case/1.0.0/openapi/statistics/case/report，例如域名是service.besclouds.com。

请求说明

表1 请求头参数
序号	名称	参数类型	是否必选	说明
1	Content-Type	string	True	消息正文的类型为JSON
2	access-token	string	True	用户访问租间token，参见调用鉴权接口

表2 请求体参数
序号	名称	参数类型	长度（字节）	是否必选	说明
1	caseTypeId	varchar	20	False	工单类型id
2	startTime	varchar	11	False	起始时间
3	endTime	varchar	11	False	结束时间
4	start	number	11	True	起始行数。（min:0）
5	limit	number	3	True	本次查询要求返回的行数。取值范围：1~100

响应说明

响应状态码: 200

表3 响应体参数
序号	名称	参数类型	是否必选	说明
1	caseStatisticsList	CaseStatisticsList []	True	工单统计信息
2	count	Number	True	符合条件的总数

表4 caseStatisticsList参数说明
序号	名称	参数类型	是否必选	说明
1	date	date	True	日期
2	caseType	varchar	False	工单类型
3	caseTypeName	varchar	False	类型名称
4	newCases	number	True	新增工单数
5	finishedCases	number	True	完成工单数
6	unfinishedCases	number	True	待处理工单数
7	averageDuration	number	True	平均处理时长，按照天为单位
8	overCases	number	True	超期工单数

消息样例

场景描述：查询工单总览统计

URL：https://域名/AICC__Case/1.0.0/openapi/statistics/case/report

请求头:

{
 "Content-Type": "application/json",
 "access-token": "0000000000************7bm63KsRmEztTvyA="
}

请求体

{"start":0,"limit":10,"startTime":"2024-09-20","endTime":"2024-10-20"}

响应头：

{ "connection": "keep-alive",
 "Content-Length": "16",
"Content-Type": "application/json%3Bcharset=UTF-8"}

响应参数：

{"resCode": "0","resMsg": "成功","result": [{ "caseStatisticsList": [{ "averageDuration": 4, "date": "2024-10-03", "finishedCases": 2,"newCases": 1, "overCases": 5, "unfinishedCases": 3 }, { "averageDuration": 44, "date": "2024-10-02", "finishedCases": 22, "newCases": 44, "overCases": 55, "unfinishedCases": 33  }, {  "averageDuration": 55, "date": "2024-10-01", "finishedCases": 23, "newCases": 12,  "overCases": 656, "unfinishedCases": 45 }
  ], "count": 3  } ]}

父主题：工单处理接口(V2.0)

上一篇：查询工单概览

下一篇：工单任务相关接口(V2.0)