POST /CCSQM/rest/ccisqm/v1/qualityitem/queryQualityItem

Scenario

This interface is invoked to query inspection tasks.

Method

POST

URI

https://Domain name/apiaccess/CCSQM/rest/ccisqm/v1/qualityitem/queryQualityItem (For example, the domain name is service.besclouds.com.)

Request Description

**Table 1** Request header parameters
No.	Parameter	Type	Mandatory or Not	Description
1	Content-Type	String	No	The value is fixed to application/json; charset=UTF-8.
2	x-app-key	String	No	App key
3	Authorization	String	Yes	Authentication field. The format is Bearer {Value of AccessToken* returned by the tokenByAkSk interface}. (A space is required after Bearer*.)
4	x-UserId	String	Yes	Operator ID You can sign in to the system and go to the employee management page to view the value of userId returned by an interface.

**Table 2** Request body parameters
No.	Parameter	Type	Mandatory or Not	Description
1.1	fixedColumns	Object	No	Conditions for advanced query
1.1.1	agentUserIds	Array	No	User IDs of agents in an agent group
1.1.2	qualityUserIds	Array	No	User IDs of inspectors in an inspection group
1.1.3	taskType	String	No	Inspection task type. The options are 1 (problem) and 2 (appeal).
1.1.4	taskStatus	Number	No	Inspection task status. The options are 21 (reviewing), 22 (completed), 24 (handling), and 27 (verifying).
1.2	startTimeMillis	Number	No	Inspection task start time. The value is a timestamp, in seconds.
1.3	endTimeMillis	Number	No	Inspection task end time. The value is a timestamp, in seconds.
1.4	rows	Number	No	Number of records on each page. The maximum value is 1000000.
1.5	page	Number	No	Page number. The minimum value is 1. The page size is determined by rows.

Response Description

Status code: 200

**Table 3** Response body parameters
No.	Parameter	Type	Mandatory or Not	Description
1.1	total	Number	No	Total number of records
1.2	pages	Number	No	Total number of pages
1.3	data	Array [Object]	No	Inspection task data
1.3.1	id	Number	No	Inspection task ID
1.3.2	taskTypeName	String	No	Appeal task type name
1.3.3	inspectorName	String	No	Inspector name
1.3.4	reviewingOfficerName	String	No	Reviewer name
1.3.5	initiatorName	String	No	Initiator name
1.3.6	taskOperatorName	String	No	Handler name
1.3.7	agentName	String	No	Previous node handler
1.3.8	taskStatusName	String	No	Appeal task status name
1.3.9	calls	Array [Object]	No	Call details list
1.3.9.1	call_uuid	String	No	Call inspection ID
1.3.10	createTimeStr	String	No	Creation time, in yyyy-MM-dd format
1.3.11	updateTimeStr	String	No	Update time, in yyyy-MM-dd format
1.3.12	setting	Object	No	Call details list
1.3.12.1	file_name	String	No	File name
1.4	pageSize	Number	No	Number of records on each page
1.5	pageNum	Number	No	Page number

Status code: 400
Incorrect request. Check the request path and parameters.
Status code: 401
Unauthorized operation. 1. Check whether you have purchased related services. 2. Contact customer service to check the status of your account.
Status code: 404
The requested content is not found. Check the request path.
Status code: 500
Business failure. Check the values of parameters in the request.

Error Codes

None

Example

Scenario: Query inspection tasks.

Request header:

x-app-key:************************************  
X-UserID:1611917095665261978  
Authorization:Bearer ********************************

Request parameters:

{
	"rows": 10000,
	"page": 1,
	"startTimeMillis": 1623318494,
	"endTimeMillis": 1623923294,
	"fixedColumns": {
		"agentUserIds": [],
		"qualityUserIds": [],
		"taskType": null,
		"taskStatus": null
	}
}

Response parameters:

{
	"data": [{
		"taskType": "APPEAL",
		"calls": [{
			"call_uuid": "8b595000-b02a-4290-9548-a4915001e89f"
		}],
		"initiatorName": "zxry0611",
		"taskOperatorName": "zxzg0611",
		"id": "16237434242323475065",
		"taskStatus": "reviewed",
		"createTimeStr": "2021-06-15 15:50:24",
		"updateTimeStr": "2021-06-15 15:50:25",
		"setting": {
			"file_name": "a1"
		}
	}, {
		"taskType": "APPEAL",
		"calls": [{
			"call_uuid": "473fbc39-f231-43f4-b1d7-7fc415c6e990"
		}],
		"initiatorName": "zxry0611",
		"taskOperatorName": "",
		"id": "16233956459326867354",
		"taskStatus": "processing",
		"createTimeStr": "2021-06-11 15:14:06",
		"updateTimeStr": "2021-06-15 15:26:00",
		"setting": {
			"file_name": "a3"
		}
	}, {
		"taskType": "APPEAL",
		"calls": [{
			"call_uuid": "473fbc39-f231-43f4-b1d7-7fc415c6e990"
		}],
		"initiatorName": "zxry0611",
		"taskOperatorName": "zxry0611",
		"id": "16233929966871311191",
		"taskStatus": "end",
		"createTimeStr": "2021-06-11 14:29:57",
		"updateTimeStr": "2021-06-11 15:06:20",
		"setting": {
			"file_name": "a3"
		}
	}]
}

Parent topic: qualityitem

Previous topic: POST /CCSQM/rest/ccisqm/v1/qualityitem/appealItem

Next topic: POST /CCSQM/rest/ccisqm/v1/qualityitem/queryQualityItemDetail