工单添加

1 功能说明

添加工单

2 接口调用说明

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

JSON

2.3 HTTP请求方式

GET, POST

2.4 IP限制

无

2.5 输入参数说明
参数名称是否必须类型描述
title是string工单的标题
requester是string工单的提交人，也是工单的发起人
content是string工单的内容
type_id否integer工单的类型编号。默认为null，0：问题，1：事务，2：故障，3：任务
priority否integer工单的优先级。默认为null，0：低，1：中，2：高，3：紧急
due_date否string工单的到期时间，仅当工单类型是任务时有此属性
field_xxx否string工单自定义字段（后缀代表工单自定义字段的编号）
tags否string工单标签，以逗号","分隔开
2.6 请求示例
http://yourdomain.kf5.com/api/v1/ticket/add?title=sometitle&content=somecontent&requester=requester@126.com&sign=12d45c66523dd069d7c64c22fea10f34
2.7 返回参数说明
参数名称说明
err返回码。0：执行成功，1：有错误
msg如果错误，返回错误信息。
datas返回数据
id工单ID编号
title工单标题
requester工单请求者
priority工单优先级
type工单的类别
due_date工单的截止时间
status工单的状态
group_id受理客服组编号
assignee_id受理客服人员编号
created工单的提交时间
assigneed工单的受理时间
resolved工单的解决时间
closed工单的关闭时间
source工单的来源
field_xxx工单自定义字段（后缀代表工单自定义字段的编号）
2.8 正确返回示例
Content-type: text/html; charset=utf-8
{
	"err":0,
	"msg":"",
	"datas":{
		"id":"123",
		"title":"sometitle",
		"requester":"requester@126.com",
	}
}
2.9 错误返回示例
Content-type: text/html; charset=utf-8
{
 	"err":1,
	"msg":"参数错误"
}

3 备注

无