一條完整的短信由短信簽名和短信內(nèi)容組成,發(fā)送短信前,您需要先申請簽名和模板,系統(tǒng)會將已審核通過的短信簽名添加到短信內(nèi)容的開頭,與短信內(nèi)容一起發(fā)送給接收方。
接口說明
-
根據(jù)工信部規(guī)定與運營商相關(guān)要求,阿里云進行了簽名相關(guān) API 的功能改造,為提升您簽名的審核效率和審核通過率,請您使用新接口CreateSmsSign-申請短信簽名。
-
個人用戶同一個阿里云賬號一個自然日支持申請一個簽名;企業(yè)用戶申請次數(shù)無限制。個人用戶與企業(yè)用戶權(quán)益區(qū)別詳情請參見使用須知。
-
通過接口申請的簽名信息會同步在短信服務(wù)控制臺,在控制臺對簽名的相關(guān)操作,請參見短信簽名。
-
提交簽名申請后,您可以通過 QuerySmsSign 接口查詢簽名審核狀態(tài)和詳情。也可以配置回執(zhí)消息,通過 SignSmsReport 獲取簽名的審核狀態(tài)消息。
QPS 限制
本接口的單用戶 QPS 限制為 1 次/秒。超過限制,API 調(diào)用會被限流,這可能會影響您的業(yè)務(wù),請合理調(diào)用。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
下表是API對應(yīng)的授權(quán)信息,可以在RAM權(quán)限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下:
- 操作:是指具體的權(quán)限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀?。≧ead)或列出(List)。
- 資源類型:是指操作中支持授權(quán)的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權(quán)的操作,用
全部資源
表示。
- 條件關(guān)鍵字:是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作:是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時具備關(guān)聯(lián)操作的權(quán)限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
---|---|---|---|---|
dysms:AddSmsSign | create | *全部資源 * |
| 無 |
請求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
SignName | string | 是 | 簽名名稱,簽名名稱請遵守簽名規(guī)范。 說明
| 阿里云 |
SignSource | integer | 是 | 簽名來源。取值:
簽名來源的詳細(xì)說明請參見簽名來源。 說明
此接口不支持申請簽名來源是測試或?qū)W習(xí)和線上試用的簽名,如果您需要申請這兩種簽名來源的簽名,請前往短信服務(wù)控制臺申請。
| 1 |
Remark | string | 是 | 短信簽名場景說明,長度不超過 200 個字符。 簽名審核的參考信息,完善申請說明有助于審核人員理解您的業(yè)務(wù)場景,提高審核效率。填寫指導(dǎo):
| 當(dāng)前的短信簽名應(yīng)用于雙11大促推廣營銷 |
SignFileList | array<object> | 是 | 簽名文件列表。 | |
object | 是 | 簽名數(shù)據(jù)。 | ||
FileContents | string | 是 | 簽名的資質(zhì)證明文件經(jīng) base64 編碼后的字符串。圖片不超過 2 MB。個別場景下,申請簽名需要上傳證明文件。 詳細(xì)規(guī)范,請參見上傳文件規(guī)范。 | R0lGODlhHAAmAKIHAKqqqsvLy0hISObm5vf394uL**** |
FileSuffix | string | 是 | 簽名的證明文件格式,支持上傳多張圖片。當(dāng)前支持 JPG、PNG、GIF 或 JPEG 格式的圖片。個別場景下,申請簽名需要上傳證明文件。 說明
如果簽名用途為他用或個人認(rèn)證用戶的自用簽名來源為企事業(yè)單位名時,還需上傳證明文件和委托授權(quán)書,詳情請參見證明文件和授權(quán)委托書。
| jpg |
SignType | integer | 否 | 簽名類型。
| 1 |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"Code": "OK",
"Message": "OK",
"RequestId": "F655A8D5-B967-440B-8683-DAD6FF8DE990",
"SignName": "阿里云"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內(nèi)容概要 | 操作 |
---|---|---|
2024-09-11 | OpenAPI 描述信息更新、OpenAPI 去除了 deprecated 標(biāo)記 | 查看變更詳情 |