帮我吧文档:数据接口:工单:工单查询器

概述

工单查询器是指过滤出满足一定条件的工单列表。

JSON格式

名称 类型 注释
id int 查询器id,系统自动分配
url varchar 查询器的资源url
title varchat 查询器名称
active tinyint 查询器是否启用,取值为:0-未启用,1-启用,默认启用。
ticket_count int 查询器包含的工单数量。用GET方式传递了fields=show_tickets_num时会显示该参数
createDT datetime查询器的创建时间
updateDT datetime查询器的更新时间

JSON示例

{
     "id": 1,
     "url": "https://www.bangwo8.com/api/v1/ticketviews/1.json",
     "title": "最近的工单列表",
     "active": "0",
     "ticket_count": "123",
     "createDT": "2017-09-12 10:12:22",
     "updateDT": "2017-09-15 11:23:12"
}

获取工单查询器列表

GET /api/v1/ticketviews.json

调用者权限

所有客服

调用参数
用GET方式传递fields=show_tickets_num可显示ticket_count参数,即该查询器过滤出的工单数量。

调用示例

  curl https://www.bangwo8.com/api/v1/ticketviews.json \
  -v -u {account}:{password}

返回值示例

Status: 200 OK
{
  "ticketviews": [
    {
      "id":123,
      "title":"最近的工单列表",
      "active":true,
      ...
    },
    ...
  ],
  "count": "7"
}

获取指定工单查询器信息

GET /api/v1/ticketviews/{id}.json

调用者权限

所有客服

调用示例

curl https://www.bangwo8.com/api/v1/ticketviews/{id}.json \
  -v -u {account}:{password}

返回值示例

Status: 200 OK

{
  "ticketview": {
      "id":123,
      "title":"最近的工单列表",
      "active":"0",
      ...
   }
}

获取指定工单查询器里的工单

GET /api/v1/ticketviews/{id}/tickets.json

调用者权限

所有客服

调用示例

curl https://www.bangwo8.com/api/v1/ticketviews/{id}/tickets.json \
  -v -u {account}:{password}

返回值示例

Status: 200 OK

{
  "tickets": [
		{
			"ticketId": 110,
			"subject": "产品咨询",
			...
		},
		{
			"ticketId": 111,
			"subject": "产品服务",
			...
		}
	]
}

获取指定工单查询器的工单个数

GET /api/v1/ticketviews/{id}/count.json

调用者权限

所有客服

调用示例

curl https://www.bangwo8.com/api/v1/ticketviews/{id}/count.json \
  -v -u {account}:{password}

返回值示例

Status: 200 OK

{
	"ticketview_count": {
		"ticketview_id": 123,
		"count": 20
	}
}

获取多个工单查询器的工单个数

GET /api/v1/ticketviews/show_many.json?ids={ids}

调用者权限

所有客服

调用示例

curl https://www.bangwo8.com/api/v1/ticketviews/show_many.json?ids={ids} \
  -v -u {account}:{password}

返回值示例

Status: 200 OK

{
	"ticketview_counts": [
	 {
		"ticketview_id": 123,
		"count": 0
	 },
	 {
		"ticketview_id": 124,
		"count": 3
	 }
	]
}

页面工具