Add

更新时间:
复制 MD 格式

Call the Add operation to submit a ticket to Alibaba Cloud for processing.

To upload attachments, first call the getOSSTempAuthor operation to obtain authorization. For more information, see getOSSTempAuthor. After you obtain authorization, upload the attachments using an Object Storage Service (OSS) client.

Request parameters

NameTypeRequiredExampleDescription
productIdIntNo12The ID of the product associated with the ticket.
Note This parameter is required if customerCommonQuestionId is not specified.
customerCommonQuestionIdIntNo-The ID of the FAQ.
Note This parameter is required if productId is not specified.
titleStringNoThis is a ticketThe title of the ticket. If this parameter is empty, the first 30 characters of the content parameter are used.
contentStringYesThis is the body of the ticket.The main body of the ticket question.
secContentStringNo-Confidential information, such as passwords or personal information.
aliUidIntYes1018******9522The UID of the user who owns the ticket.
phoneStringNo139********The phone number used to receive system notifications or calls from customer service.
smsAlertTimeStringNonormalThe preferred time period for text message alerts. Valid values:
  • all: sends alerts at any time.
  • normal: sends alerts from 09:00 to 18:00 daily.
emailStringNozhang***@****.comThe email address used to receive system notifications or messages from customer service.
attachmentsStringNo-The names of the attachments uploaded using an OSS client.
Note If there are multiple attachments, separate their names with commas (,). You can upload a maximum of three attachments.

Response parameters

NameTypeExampleDescription
dataString8M***UYThe data returned by the operation. If the call is successful, the ID of the newly created ticket is returned.
successStringtrueIndicates whether the operation call was successful.
  • true: The call was successful.
  • false: The call failed.
messageStringsuccessfulThe error message. If the operation call fails, a detailed error message is returned for troubleshooting.
codeInt200The error code.
Note productId and customerCommonQuestionId, see the Excel sheet provided by Alibaba Cloud technical support.

Request example

https://workorder.aliyuncs.com/?Action=Add
&productId=12
&content=This is the body of the ticket.
&aliUid=1018******9522

Response example

{  
   "message": "successful",
   "data": "8M***UY", 
   "code": "200",  
   "success": true
}

Error codes

HttpCodeError codeError messageDescription
200SUCCESSsuccessfulThe request was processed successfully.
-121ILLEGAL_AUTHillegal authYou do not have the required permissions.
-101ILLEGAL_PARAMillegal parameter, param is xxx The parameter xxx failed the validation.
-104ILLEGAL_PARAM_EMPTYxxx must not be null or emptyThe parameter cannot be empty.
-153SYSTEM_BUSYthe system is busyA system exception occurred.