Updated on 2023-09-27 GMT+08:00

POST /CCSQM/rest/ccisqm/v1/qualitytask/callsQualityTask

Scenario

This interface is invoked to query sample inspection task details.

Method

POST

URI

https://Domain name/apiaccess/CCSQM/rest/ccisqm/v1/qualitytask/callsQualityTask (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

currentRole

String

Yes

User role

1.2

page

Number

Yes

Page number. Pagination information.

1.3

rows

Number

Yes

Number of records on each page. Pagination information.

1.4

fixedColumns

Object

Yes

Sample inspection task details

1.4.1

planCode

String

Yes

Sample inspection task code. The value can contain a maximum of 128 characters.

1.4.2

showReviewingOfficer

Boolean

No

Whether to display only tasks assigned to reviewers.

1.4.3

inspectStatus

String

No

Sample inspection status. The options are -1, 0, 1, and 3.

1.4.4

inspector

String

No

Sample inspector. The value can contain a maximum of 256 characters.

1.4.5

fileName

String

No

File name. The value can contain a maximum of 256 characters.

1.4.6

reviewingOfficer

String

No

Reviewer. The value can contain a maximum of 256 characters.

1.4.7

reviewingStates

String

No

Review status. The options are -1, 0, 2, and 3.

1.4.8

staff

String

No

Agent. The value can contain a maximum of 256 characters.

1.4.9

durationFrom

Number

No

Start time of a call duration range

1.4.10

durationTo

Number

No

End time of a call duration range

Response Description

  • Status code: 200
Table 3 Response body parameters

No.

Parameter

Type

Mandatory or Not

Description

1.1

total

Number

Yes

Total number of records

1.2

data

Array [Object]

Yes

Queried data

1.2.1

id

Number

No

Task ID

1.2.2

inspector

String

No

Inspector

1.2.3

inspectStatus

Number

No

Inspection status

1.2.4

calls

Array [Object]

No

Call list

1.2.4.1

call_id

String

No

Call business ID

1.2.4.2

file_name

String

No

File name

1.2.4.3

duration

Number

No

Call duration

1.2.4.4

upload_time

Number

No

Upload time

1.2.4.5

call_time

Number

No

Call start time

1.2.4.6

call_uuid

String

No

Call business ID

1.2.4.7

taskId

Number

No

Task ID

1.2.4.8

call_type

Number

No

Call type

1.2.4.9

inspectStatus

Number

No

Inspection status

1.2.4.10

leftChannel

String

No

Left channel

1.2.4.11

leftSpeechRatio

Number

No

Left channel speaking proportion

1.2.4.12

rightSpeechRatio

Number

No

Right channel speaking proportion

1.2.5

setting

Object

No

Extended information

1.2.5.1

call_id

String

No

Call details ID

1.2.5.2

taskId

Number

No

Task ID

1.2.5.3

staffId

String

No

Agent ID

1.2.5.4

staff_name

String

No

Agent name

1.2.6

inspectorName

String

No

Sample inspector name

1.2.7

is_group

Boolean

No

Whether a call is an associated call

1.3

resultCode

String

No

Return code

  • 0409000: success
  • Others: failure

1.4

resultDesc

String

No

Return description

  • 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 sample inspection task details.

    Request header:

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

    Request parameters:

    {
    	"currentRole": "qualityDirector",
    	"page": 1,
    	"rows": 10,
    	"fixedColumns": {
    		"planCode": "125092321715122176",
    		"showReviewingOfficer": false,
    		"inspectStatus": "5"
    	}
    }

    Response parameters:

    {
    	"total": 1,
    	"pages": 0,
    	"data": [{
    		"calls": [{
    			"duration": 347.16,
    			"upload_time": 1609143922,
    			"rightSpeechRatio": "0.2446",
    			"file_name": "766",
    			"leftSpeechRatio": "0.1933",
    			"call_time": 1609143921,
    			"leftChannel": "staff",
    			"call_uuid": "c6a31191-6c69-486b-b8f9-c3412ef44bfd",
    			"inspectStatus": 0,
    			"call_type": 0,
    			"taskId": "954153162039409666",
    			"call_id": "954155173359172609"
    		}],
    		"id": "954153162039409666",
    		"inspector": "1600226476732482572",
    		"inspectStatus": 0,
    		"inspectorName": "zjrylong",
    		"is_group": false,
    		"setting": {
    			"staff_name": "zxrylong",
    			"staffId": "1600226440112042215",
    			"taskId": "954153162039409666",
    			"call_id": "954155173359172609"
    		}
    	}],
    	"resultCode": "0409000",
    	"resultDesc": "success"
    }