工单搜索

1 功能说明

搜索工单

2 接口调用说明

2.1 URL
http://yourdomain.kf5.com/api/v1/ticket/search
2.2 格式

JSON

2.3 HTTP请求方式

GET, POST

2.4 IP限制

无

2.5 输入参数说明
参数名称是否必须类型描述
title是string工单的标题
currentpage否integer当前显示的数据页数，默认为1，表示第一页
pagesize否integer每页显示的记录条数，默认为20条
status否integer工单的状态。0：未受理，1：受理中，2：等待回复，3：已解决，4：已关闭
type_id否integer工单的类别编号。默认为null，0：问题，1：事务，2：故障，3：任务
priority否integer工单的优先级。默认为null，0：低，1：中，2：高，3：紧急
source否string工单的提交来源。web：帮助台网页，tab：浮动窗口，chat：在线交谈
2.6 请求示例
http://yourdomain.kf5.com/api/v1/ticket/search?title=222&pagesize=10&sign=12d45c66523dd069d7c64c22fea10f34
2.7 返回参数说明
参数名称说明
err返回码。0：执行成功，1：有错误
msg如果错误，返回错误信息。
count搜索到的记录总数
currentpage当前显示的第几页
pagesize分页大小
datas返回数据
id工单id
title工单标题
requester工单请求者
priority工单优先级。默认为null，0：低，1：中，2：高，3：紧急
type_id工单的类别。默认为null，0：问题，1：事务，2：故障，3：任务
assignee_id工单的受理客服编号
group_id工单的受理客服组编号
created工单的创建时间
assigneed工单的受理时间
resolved工单的解决时间
closed工单的关闭时间
status工单的状态。0：未受理，1：受理中，2：等待回复，3：已解决，4：已关闭
source工单的来源
2.8 正确返回示例
Content-type: text/html; charset=utf-8
{
	"err":0,
	"msg":"",
	"count":"1",
	"currentpage":"1",
	"pagesize":"20",
	"datas":{
		"0":{
			"id":"100",
			"title":"title",
			"requester_id":"234",
			...
		}
		...
	}
}
2.9 错误返回示例
Content-type: text/html; charset=utf-8
{
 	"err":1,
	"msg":"参数不完整"
}

3 备注

无