Service Ticket Operations

Updated on 2025-02-10 GMT+08:00

View PDF

Function

Perform operations on a service ticket.

URI

POST /v2/servicerequest/cases/{case_id}/action

**Table 1** Path parameters
Parameter	Mandatory	Type	Description
case_id	Yes	String	Specifies the service ticket ID. Minimum length: 1 Maximum length: 64

**Table 2** Query parameters
Parameter	Mandatory	Type	Description
action_id	Yes	String	Specifies the operation (such as cancel, close, press, and delete). Minimum length: 1 Maximum length: 64

Request Parameters

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Specifies the user token. It can be obtained by calling the IAM API (value of X-Subject-Token in the response header). Minimum length: 1 Maximum length: 5000
X-Language	No	String	Specifies the language environment. The value is a common language description character string, for example, zh-cn. It is zh-cn by default. Some internationalization information, such as the service ticket type and name, is displayed based on the language environment. Minimum length: 1 Maximum length: 32
X-Time-Zone	No	String	Specifies the time zone. The value is a common time zone description character string, for example, GMT+8. It is GMT+8 by default. Time-related data is processed based on the time zone of the environment. Minimum length: 1 Maximum length: 32

**Table 4** Request body parameters
Parameter	Mandatory	Type	Description
judgment	No	String	Indicates the evaluation content. Minimum length: 0 Maximum length: 400
operate_desc	No	String	Description of the operation. Minimum length: 0 Maximum length: 400
group_id	No	String	Specifies the group ID. Minimum length: 0 Maximum length: 64
incident_satisfaction_list	No	Array of IncidentSatisfactionV2Do objects	Specifies the service ticket satisfaction list.

**Table 5** IncidentSatisfactionV2Do
Parameter	Mandatory	Type	Description
value	No	Integer	Specifies the total score of satisfaction. Minimum value: 0 Maximum value: 65535
satisfaction_id	Yes	Integer	Specifies the satisfaction category ID. Minimum value: 0 Maximum value: 9999
satisfaction_value	Yes	Integer	Specifies the satisfaction value. Minimum value: 0 Maximum value: 65535
satisfaction_name	No	String	Specifies the satisfaction category name. Minimum length: 0 Maximum length: 32
per_value	No	Integer	Specifies the score of a scale. Minimum value: 0 Maximum value: 65535
sat_category_id	No	String	Specifies the satisfaction dimension ID. Minimum length: 0 Maximum length: 32
sat_category_name	No	String	Specifies the satisfaction dimension name. Minimum length: 0 Maximum length: 32

Response Parameters

Status code: 200

**Table 6** Response body parameters
Parameter	Type	Description
error_code	String	Specifies the error code. Minimum length: 0 Maximum length: 32
error_msg	String	Description of the error. Minimum length: 0 Maximum length: 32

Request Example

POST https://{endpoint}/v2/servicerequest/cases/case-123/action?action_id=press

{
  "judgment" : "test",
  "operate_desc" : "test",
  "group_id" : "123456"
}