修改未通過審核的模板,調用本接口修改后將自動提交審核。
接口說明
-
新接口和原接口變更的公告詳情請參見關于短信服務更新簽名&模板接口的公告。
-
僅支持修改未通過審核的模板,請參考短信審核失敗的處理建議,調用此接口修改后重新提交審核。
-
通過接口修改模板的操作會在短信服務控制臺同步,在控制臺對模板的相關操作,請參見短信模板。
QPS 限制
本接口的單用戶 QPS 限制為 1000 次/秒。超過限制,API 調用會被限流,這可能會影響您的業務,請合理調用。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
dysms:UpdateSmsTemplate | none | *全部資源 * |
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
TemplateName | string | 是 | 模板名稱,長度不超過 30 個字符。 | 驗證碼 |
TemplateCode | string | 是 | 未通過審核的模板 Code。 | SMS_152550**** |
TemplateContent | string | 是 | 模板內容,長度不超過 500 個字符。 模板內容和變量內容必須符合短信規范,否則模板會審核失敗。您也可以在申請模板頁面,查看常用模板示例。使用示例模板可提高審核效率和成功率。變量規范請參見 TemplateContent 參數變量規范。 | 您正在申請手機注冊,驗證碼為:${code},5分鐘內有效! |
Remark | string | 否 | 請描述您使用短信的業務場景或提供業務場景的線上鏈接,并提供短信完整示例(填入變量內容),信息完整有助于提高模板審核通過率。如未按規范進行填寫或不填寫,可能會影響您模板審核的通過。 | 登錄場景使用驗證碼 |
TemplateType | integer | 是 | 0 | |
RelatedSignName | string | 否 | 模板申請時關聯的短信簽名。 | 阿里云 |
TemplateRule | string | 否 | 模板變量規則。 變量規則填寫請參見示例文檔。 | {"code":"characterWithNumber"} |
MoreData | array | 否 | 更多資料,補充上傳業務證明文件或業務截圖,有助于審核人員了解您的業務詳情。非必填,可不設置。 | |
string | 否 | 上傳到 OSS 的文件信息。 文件上傳操作,請參見 OSS 上傳文件。 | 10098689758****/1234qwe.png | |
ApplySceneContent | string | 否 | 如有應用場景可進行填寫。 | http://www.aliyun.com/ |
IntlType | integer | 否 | 國際/港澳臺模板類型。當 TemplateType 參數為 3 時,國際/港澳臺模板需要設置此參數,取值:
| 0 |
返回參數
示例
正常返回示例
JSON
格式
{
"RequestId": "819BE656-D2E0-4858-8B21-B2E477085AAF",
"Code": "OK",
"Message": "OK",
"TemplateName": "驗證碼",
"TemplateCode": "SMS_152550****",
"OrderId": "20041271****"
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | ForbiddenAction | Access to the account is denied. Please contact the administrator. | 沒有訪問權限,請聯系管理員 |
400 | AssocSignUnapproved | Associated signature must be approved. | 關聯簽名需使用審核通過簽名。 |
400 | InvalidTemplateRule | The template variable format is non-standard. Please refer to the variable format specifications in the help documentation. | 模版變量不符合規范,請查看http://bestwisewords.com/zh/sms/ user-guide/message-template-specifications/ |
400 | InvalidTemplateRule.Format | The parameter TemplateRule format must be JSON. | 模板變量規則格式必須為json格式。 |
400 | InvalidTemplateRule.Format | The template variable does not conform to the specification, please check the http://bestwisewords.com/zh/sms/user-guide/message-template-specifications/. | 模版變量不符合規范,請查看http://bestwisewords.com/zh/sms/ user-guide/message-template-specifications/ |
400 | InvalidMoreData | Specified parameter MoreData is not valid. | 上傳的更多資料無效。 |
400 | TemplateVarLimitExceeded | The verification code template only supports one variable. | 驗證碼模板僅支持1個變量。 |
400 | InvalidTemplateContent.Format | Invalid template content format. | 模板內容格式不正確。 |
400 | ServiceNotOpened | This product service is not opened. | 產品服務未開通 |
404 | MissingTemplateName | The template name cannot be empty. | 模板名稱不能為空。 |
404 | SmsSignatureNotFound | The associated SMS signature does not exist. | 關聯的短信簽名不存在。 |
訪問錯誤中心查看更多錯誤碼。