調用 Add 提交一個阿里云工單，阿里云會針對工單反饋的內容作后續處理。
如果調用方需要上傳附件則需先調用 getOSSTempAuthor 接口獲取授權，授權接口詳細信息請參見getOSSTempAuthor。獲取授權后再通過 OSS 客戶端自行上傳附件。
請求參數
| 名稱 | 類型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
| productId | Int | 否 | 12 | 工單對應的產品 ID
說明 customerCommonQuestionId 未填時該參數必填 。
|
| customerCommonQuestionId | Int | 否 | - | 常見問題 ID
說明 productId 未填時必填。
|
| title | String | 否 | 這個是一個工單 | 工單標題，該參數為空時取 content 參數值的前 30 個字符 |
| content | String | 是 | 這是工單的正文 | 工單提問正文 |
| secContent | String | 否 | - | 機密信息（密碼、個人信息等） |
| aliUid | Int | 是 | 1018******9522 | 工單歸屬的用戶的 UID |
| phone | String | 否 | 139******** | 手機號，用于接收系統通知或客服來電 |
| smsAlertTime | String | 否 | normal | 短信提醒的時間段偏好，取值：
|
| String | 否 | zhang***@****.com | 郵箱，用來接收系統通知或客服信息 | |
| attachments | Stirng | 否 | - | 通過 OSS 客戶端上傳的附件名稱
說明 如果有多個附件，以逗號（,）分隔，最多支持上傳 3 個附件。
|
返回參數
| 名稱 | 類型 | 示例值 | 描述 |
|---|---|---|---|
| data | String | 8M***UY | 接口返回數據，成功時返回新創建工單的 ID |
| success | String | true | 接口調用是否成功
|
| message | String | successful | 錯誤信息。接口返回失敗時，顯示詳細的錯誤提示，用于接口調用自查。 |
| code | Int | 200 | 錯誤碼 |
說明 productId 和 customerCommonQuestionId 對應的產品名稱和常見問題名稱請參照阿里云技術人員提供的 Execl 表格。
請求示例
https://workorder.aliyuncs.com/?Action=Add
&productId=12
&content=這是工單的正文
&aliUid=1018******9522返回示例
{
"message": "successful",
"data": "8M***UY",
"code": "200",
"success": true
}錯誤碼
| HttpCode | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 200 | SUCCESS | successful | 業務處理成功 |
| -121 | ILLEGAL_AUTH | illegal auth | 沒有權限 |
| -101 | ILLEGAL_PARAM | illegal parameter, param is xxx | 參數xxx未通過校驗 |
| -104 | ILLEGAL_PARAM_EMPTY | xxx must not be null or empty | 參數不能為空 |
| -153 | SYSTEM_BUSY | the system is busy | 系統異常 |