全部產品
Search
文件中心

Short Message Service:BatchSendMessageToGlobe - 批量傳送簡訊到中國境外

更新時間:Dec 11, 2025

批量傳送簡訊到中國境外。

介面說明

  • 該介面不支援往中國內地傳送簡訊。

  • BatchSendMessageToGlobe 介面主要小批量發送推廣類、通知類簡訊。大批量傳送簡訊請使用簡訊控制台的快速發送功能。

  • 若對簡訊時效性有要求,請使用 SendMessageToGlobe 介面。

  • 在一次請求中,最多可以向 1000 個手機號碼分別傳送簡訊。

QPS 限制

本介面的單使用者(同一個阿里雲帳號)QPS 限制為 1 次/秒。超過限制,API 呼叫會被限流,這可能會影響您的業務,請合理調用。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

dysms:BatchSendMessageToGlobe

create

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

To

string

接收方號碼。號碼格式為:國際區號+號碼。

電話代碼詳情,請參見電話代碼

[\"931520581****\",\"931530581****\",\"931540581****\",\"931550581****\"]

From

string

發送方號碼。支援 Sender ID 的發送,只允許數字、字母,含有字母標識最長 11 位,純數位識別碼支援 15 位。

Alicloud321

Message

string

簡訊內容。

[\"message to 931520581****\",\"message to 931530581****\",\"message to 931540581****\",\"message to 931550581****\"]

Type

string

簡訊類型。取值:

  • NOTIFY:通知簡訊。

  • MKT:推廣簡訊。

NOTIFY

TaskId

string

任務 ID。長度不超過 255 個字元。可以在簡訊回執訊息體的 TaskId 欄位擷取。

123789****

ValidityPeriod

integer

簡訊有效時間長度,單位:秒。

600

ChannelId

string

簡訊通道 id

sms-djnfjn344

返回參數

名稱

類型

描述

樣本值

object

介面返回參數。

ResponseCode

string

狀態代碼。返回 OK 代表請求成功,其他錯誤碼,請參見錯誤碼列表

OK

RequestId

string

請求 ID。

F655A8D5-B967-440B-8683-DAD6FF8D28D3

FailedList

string

發送失敗的號碼列表。

["931520581****","931530581****"]

ResponseDescription

string

狀態代碼描述。

The SMS Send Request was accepted

From

string

發送方標識,返回傳入的 Sender ID。

Alicloud321

MessageIdList

string

發送成功的訊息 ID。

["123****","124****"]

SuccessCount

string

成功發送條數。

2

樣本

正常返回樣本

JSON格式

{
  "ResponseCode": "OK",
  "RequestId": "F655A8D5-B967-440B-8683-DAD6FF8D28D3",
  "FailedList": "[\"931520581****\",\"931530581****\"]",
  "ResponseDescription": "The SMS Send Request was accepted",
  "From": "Alicloud321",
  "MessageIdList": "[\"123****\",\"124****\"]",
  "SuccessCount": "2"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情