π«Tickets
General data
This section contains ticket-related corresponding data, such as codes for "status", "priority", etc.
statuses
Name
value
Pending
0
processing
1
Resolved
2
Closed
3
priority
Name
value
low
0
medium
1
high
2
urgent
3
Search tickets
Search tickets based on various conditions; see the table below for details
In addition to the ticket's own information, it also includes related customer, category, subcategory, contact records, handlers, sponsors, and other information.
Query Parameters
PARAMETER
REQUIRED
DEFAULT
TYPE
DESCRIPTION
page
false
1
Number
Which page is currently on
per_page
false
15
Number
How many items to display per page
search
false
NULL
String
Fuzzy search ticket title and content
contact_id
false
NULL
Number
customer id
statuses
false
NULL
Array
ticket status < 0: pending 1: processing 2: resolved 3: closed >
due_at__start
false
NULL
Datetime
due date/time (start)
due_at__end
false
NULL
Datetime
due date/time (end)
created_at__start
false
NULL
Datetime
created_at__start
created_at__end
false
NULL
Datetime
created date/time (end)
sponsor_id
false
NULL
Number
sponsor id
termination_code_ids
false
NULL
Array
array of termination code ids
handler_ids
false
NULL
Array
array of ids of employees handling the ticket
creater_ids
false
NULL
Array
array of ids of employees who created the ticket
Response
Get ticket
Create ticket
Form Data
PARAMETER
REQUIRED
DEFAULT
TYPE
DESCRIPTION
sponsor_id
false
NULL
Number
sponsor id
handler_id
false
NULL
Number
handler employee id
termination_code_id
false
NULL
Number
termination code id
subject
true
NULL
String
ticket title
content
true
NULL
String
ticket content
due_at
false
NULL
Datetime
ticket due time
priority
false
0(lowest)
Number
ticket priority level
status
false
0(pending)
Number
ticket processing status
status_memo
false
NULL
String
ticket status note
sub_category_id
false
NULL
Number
subcategory
contact_id
false
NULL
Number
customer id
Response
Please refer to Ticket Response format
PROPERTY
TYPE
DESCRIPTION
View ticket
URL Parameters
PARAMETER
DESCRIPTION
id
ticket id
Response
Please refer to Ticket Response format
Update ticket
URL Parameters
PARAMETER
DESCRIPTION
id
ticket id
Form Data
PARAMETER
REQUIRED
DEFAULT
TYPE
DESCRIPTION
sponsor_id
false
NULL
Number
sponsor id
handler_id
false
NULL
Number
handler employee id
termination_code_id
false
NULL
Number
termination code id
subject
false
NULL
String
ticket title
content
false
NULL
String
ticket content
due_at
false
NULL
Datetime
ticket due time
priority
false
0(lowest)
Number
ticket priority level
status
false
0(pending)
Number
ticket processing status
status_memo
false
NULL
String
ticket status note
sub_category_id
false
NULL
Number
subcategory
contact_id
false
NULL
Number
customer id
Response
Please refer to Ticket Response format
Delete ticket
Http status is 204
URL Parameters
PARAMETER
DESCRIPTION
id
ticket id
Search employees
Query Parameters
PARAMETER
REQUIRED
DEFAULT
TYPE
DESCRIPTION
page
false
1
Number
Which page is currently on
per_page
false
15
Number
How many items to display per page
search
false
NULL
String
Fuzzy search employee name, ID card, employee number
Response
Search sponsors
Response
Search ticket termination codes
Query Parameters
PARAMETER
REQUIRED
DEFAULT
TYPE
DESCRIPTION
page
false
1
Number
Which page is currently on
per_page
false
15
Number
How many items to display per page
search
false
NULL
String
Fuzzy search employee name, ID card, employee number
Response
Response
PROPERTY
TYPE
DESCRIPTION
id
Number
termination code id
name
String
termination code name
description
String
termination code description
status
Number
corresponding ticket status <0: pending 1: processing 2: completed 3: closed>
creater_id
Number
id of the employee who created that termination code
Search categories
Query Parameters
PARAMETER
REQUIRED
DEFAULT
TYPE
DESCRIPTION
page
false
1
Number
Which page is currently on
per_page
false
15
Number
How many items to display per page
Response
Search subcategories
Query Parameters
PARAMETER
REQUIRED
DEFAULT
TYPE
DESCRIPTION
page
false
1
Number
Which page is currently on
per_page
false
15
Number
How many items to display per page
category_id
false
Number
parent category id
Response
Last updated