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

POST /CCSQM/rest/ccisqm/v1/speedrule/querySpeedRuleById

Scenario

This interface is invoked to query speed rule details by ID. The query criterion is speed_id, which indicates the unique ID of a speed rule and is mandatory.

Method

POST

URI

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

No

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

speed_id

String

Yes

Speed rule ID

Response Description

  • Status code: 200
Table 3 Response body parameters

No.

Parameter

Type

Mandatory or Not

Description

1.1

exception

Object

No

Exception information

1.1.1

under

Object

No

Condition that the speed is less than the minimum limit

1.1.1.1

customer

Array [Object]

No

Sentences said by the customer

1.1.1.1.1

sentence_id

String

No

Sentence ID

1.1.1.1.2

sentence_name

String

No

Sentence name

1.1.1.1.3

category_id

String

No

Sentence category ID

1.1.2

over

Object

No

Condition that the speed is greater than the maximum limit

1.1.2.1

customer

Array [Object]

No

Sentences said by the customer

1.1.2.1.1

sentence_id

String

No

Sentence ID

1.1.2.1.2

sentence_name

String

No

Sentence name

1.1.2.1.3

category_id

String

No

Sentence category ID

1.2

setting

Object

No

Basic information

1.2.1

name

String

No

Speed rule name

1.2.2

score

Number

No

Points deducted due to violation. The value ranges from 0 to 100.

1.2.3

min

Number

No

Minimum speed, which is the minimum number of words per minute. The value ranges from 1 to 220.

1.2.4

max

Number

No

Maximum speed, which is the maximum number of words per minute. The value ranges from 1 to 2147483647.

1.2.5

speed_id

String

No

Speed rule ID

1.2.6

other

Object

No

Trigger conditions (start time and end time)

1.2.6.1

call_end

Number

No

Call start time, in milliseconds

1.2.6.2

call_from

Number

No

Call end time, in milliseconds

1.3

resultCode

String

Yes

Return code. The value 0405000 indicates success, and other values indicate failure.

1.4

resultDesc

String

Yes

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 speed rule details by ID.

    Request header:

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

    Request parameters:

    {
    	"speed_id": "849706874868600832"
    }

    Response parameters:

    {
    	"exception": {
    		"over": {
    			"customer": []
    		},
    		"under": {
    			"customer": []
    		}
    	},
    	"resultCode": "0405000",
    	"resultDesc": "Operation successful."
    	"setting": {
    		"score": "-3",
    		"other": {
    			"call_end": 0,
    			"call_from": 0
    		},
    		"min": "90",
    		"max": "150",
    		"name": "Speed rule",
    		"speed_id": "925095745760006144"
    	}
    }