文档首页/云客服/API参考/系统配置类接口参考（API Fabric）/Case2.0工单接口/工单配置接口(V2.0)/查询工单类型列表
更新时间：2025-11-13 GMT+08:00
查看PDF
分享

查询工单类型列表

描述

按照条件查询工单类型列表，支持按照类型名称模糊查询、状态过滤和分页查询，默认最大分页100条。

接口方法

POST

接口URI

https://域名/service/AICC__Case/1.0.0/openapi/caseType/list，例如域名是service.besclouds.com。

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

Content-Type

string

True

消息正文的类型为JSON

2

access-token

string

True

用户访问租间token

表2 请求体参数

序号

名称

参数类型

长度（字节）

是否必选

说明

1

typeName

string

128

False

工单类型名称模糊查询

2

status

string

-

False

类型状态，Active/Inactive

3

start

number

-

True

起始行数。（min:0）

4

limit

number

-

True

本次查询要求返回的行数（min：1，max:100）

响应说明

  • 响应状态码: 200
表3 响应体参数

序号

名称

参数类型

是否必选

说明

1

caseTypes

CaseTypes[]

True

工单类型信息，参见表4。

2

count

number

True

符合条件的总数

表4 CaseTypes参数说明

序号

名称

参数类型

是否必选

说明

1

id

string

True

工单类型id

2

typeName

string

True

工单模板名称（唯一）

3

description

string

False

工单类型描述

4

status

string

True

类型状态

5

caseStatus

string

True

工单状态，多个用,分隔

6

templateId

string

True

关联的工单模板

7

templateName

string

True

关联的工单模板名称

8

contentTempalteId

string

False

关联的内容模板

9

parentId

string

False

父类型id

10

isStrictOrder

boolean

True

是否严格模式

11

creatorName

string

True

创建人名称

12

createdDate

Datetime

True

创建时间

13

lastModifiedName

string

True

最后修改人名称

14

lastModifiedDate

Datetime

True

最后修改时间

消息样例

场景描述：查询工单类型列表

URL：https://域名/service/AICC__Case/1.0.0/openapi/caseType/list

  • 请求头:
{
 "Content-Type": "application/json"，
 "access-token": "0000000000************7bm63KsRmEztTvyA="
}
  • 请求体：
{
  "limit": 2,"start": 0
}
  • 响应头：
{ "connection": "keep-alive",
 "Content-Length": "16",
"Content-Type": "application/json%3Bcharset=UTF-8"}
  • 响应参数： 
    {
	"resCode": "0",
	"resMsg": "成功",
	"result": {
		"caseTypes": [{
			"caseStatus": "y,Completed",
			"contentTemplateId": null,
			"createdDate": "2023-06-16 10:46:37",
			"creatorName": "qianbin001",
			"description": "bbb",
			"id": "cvmC00000149PQzoNeq0",
			"isStrictOrder": false,
			"lastModifiedDate": "2023-06-16 10:46:58",
			"lastModifiedName": "10gd00000143C5ONGb0y",
			"parentId": null,
			"status": "Active",
			"templateId": "c7s800000149PO9VmEWu",
			"templateName": "bbbb",
			"typeName": "bbb"
		}, {
			"caseStatus": "y,Completed",
			"contentTemplateId": null,
			"createdDate": "2023-06-16 10:26:31",
			"creatorName": "qianbin001",
			"description": "aaa",
			"id": "cvmC00000149NzxF1ePA",
			"isStrictOrder": false,
			"lastModifiedDate": "2023-06-16 10:26:50",
			"lastModifiedName": "10gd00000143C5ONGb0y",
			"parentId": null,
			"status": "Active",
			"templateId": "c7s800000149NtKyh4me",
			"templateName": "aaa",
			"typeName": "aaa"
		}],
		"count": 65
	}
}