文档首页/ 云客服/ API参考/ Case2.0接口参考/ 工单处理接口(V2.0)/ 查询工单总览统计
更新时间：2025-03-07 GMT+08:00
查看PDF
分享

查询工单总览统计

描述

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

接口方法

POST

接口URI

https://域名/service/AICC__Case/1.0.0/openapi/statistics/case/current，例如域名是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  } ]}