工单列表

GET /apiv2/tickets.json
Query参数
NameRequiredTypeComment
created_startstring按创建时间筛选,开始时间
created_endstring按创建时间筛选,结束时间
updated_startstring按更新时间筛选,开始时间
updated_endstring按更新时间筛选,结束时间
created_orderstring按创建时间排序,可选值:asc、desc
updated_orderstring按更新时间排序,可选值:asc、desc
status_orderstring按工单状态排序,可选值:asc、desc
field_orderstring按工单自定义字段排序,参数格式:field_690_asc 或 field_690_desc,field_690 为字段名,
可以通过 工单自定义字段接口 获得
pagenumber页码,默认为 1
per_pagenumber分页尺寸,默认为 100

备注:分页返回所有工单,默认排序为按编号升序排列。按创建和更新时间进行筛选的参数 created_start、created_end、updated_start、updated_end,支持日期格式(如 2016-01-01 00:00:00)和时间戳(秒级别的整型)。

调用权限

admin

也可以使用如下API:

查看指定客服受理的工单(可指定工单状态)
GET /apiv2/users/{user_id}/tickets.json
可传参数
NameRequiredTypeComment
statusstring工单状态,可选值有"new","open", "pending", "solved", "closed",查询多个状态时请用英文逗号隔开
curl示例
curl https://{subdomain}.kf5.com/apiv2/users/123456/tickets.json \
  -v -u {email_address}:{password}
curl https://{subdomain}.kf5.com/apiv2/users/123456/tickets.json?status=open \
  -v -u {email_address}:{password}
curl https://{subdomain}.kf5.com/apiv2/users/123456/tickets.json?status=open,pending \
  -v -u {email_address}:{password}

Note: 客服查看工单列表请使用 Views API

curl示例
curl https://{subdomain}.kf5.com/apiv2/tickets.json \
  -v -u {email_address}:{password}
返回示例
Status: 200 OK{
	"tickets": [
		{
			"id": 1,
			"title": "您好,您有一个工单需要处理",
			"template_id": "100025",
            "template": "新模板",
			...		},
		{
			"id": 2,
			"title": "您好,您还有一个工单需要处理",
			"template_id": "100025",
            "template": "新模板",
			...		}
	]}