工单列表
GET /apiv2/tickets.json
Query参数
| Name | Required | Type | Comment |
|---|---|---|---|
| created_start | 否 | string | 按创建时间筛选，开始时间 |
| created_end | 否 | string | 按创建时间筛选，结束时间 |
| updated_start | 否 | string | 按更新时间筛选，开始时间 |
| updated_end | 否 | string | 按更新时间筛选，结束时间 |
| created_order | 否 | string | 按创建时间排序，可选值：asc、desc |
| updated_order | 否 | string | 按更新时间排序，可选值：asc、desc |
| status_order | 否 | string | 按工单状态排序，可选值：asc、desc |
| field_order | 否 | string | 按工单自定义字段排序，参数格式：field_690_asc 或 field_690_desc，field_690 为字段名， 可以通过 工单自定义字段接口 获得 |
| page | 否 | number | 页码，默认为 1 |
| per_page | 否 | number | 分页尺寸，默认为 100 |
备注：分页返回所有工单，默认排序为按编号升序排列。按创建和更新时间进行筛选的参数 created_start、created_end、updated_start、updated_end，支持日期格式（如 2016-01-01 00:00:00）和时间戳（秒级别的整型）。
调用权限
admin
也可以使用如下API：
查看指定客服受理的工单(可指定工单状态)
GET /apiv2/users/{user_id}/tickets.json可传参数
| Name | Required | Type | Comment |
|---|---|---|---|
| status | 否 | string | 工单状态，可选值有"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": "新模板",
... }
]}