BatchSendMessageToGlobe
批量发送短信到中国境外
服务地址:
西南1(成都)
输入参数
只看必填
To接收方号码
From发送方号码
Message短信内容
Type短信类型
TaskId任务ID
ValidityPeriod短信有效时长
ChannelId短信通道id
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

  • 该接口不支持往中国内地发送短信。
  • BatchSendMessageToGlobe 接口主要小批量发送推广类、通知类短信。大批量发送短信请使用短信控制台的快速发送功能。
  • 若对短信时效性有要求,请使用 SendMessageToGlobe 接口。
  • 在一次请求中,最多可以向 1000 个手机号码分别发送短信。

QPS 限制

本接口的单用户(同一个阿里云账号)QPS 限制为 1 次/秒。超过限制,API 调用会被限流,这可能会影响您的业务,请合理调用。

请求参数

字段名称字段详情
Tostring

接收方号码。号码格式为:国际区号+号码。展开详情

示例值:[\"931520581****\",\"931530581****\",\"931540581****\",\"931550581****\"]
Fromstring

发送方号码。支持 Sender ID 的发送,只允许数字、字母,含有字母标识最长 11 位,纯数字标识支持 15 位。

示例值:Alicloud321
Messagestring

短信内容。

示例值:[\"message to 931520581****\",\"message to 931530581****\",\"message to 931540581****\",\"message to 931550581****\"]参考取值来源:
    SendMessageToGlobe
Typestring

短信类型。取值:展开详情

示例值:NOTIFY
TaskIdstring

任务 ID。长度不超过 255 个字符。可以在短信回执消息体的 TaskId 字段获取。

示例值:123789****
ValidityPeriodinteger<int64>

短信有效时长,单位:秒。

注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
示例值:600
ChannelIdstring

短信通道 id

示例值:sms-djnfjn344

返回参数

字段名称字段详情
ResponseCodestring

状态码。返回 OK 代表请求成功,其他错误码,请参见错误码列表

示例值:OK
RequestIdstring

请求 ID。

示例值:F655A8D5-B967-440B-8683-DAD6FF8D28D3
FailedListstring

发送失败的号码列表。

示例值:["931520581****","931530581****"]
ResponseDescriptionstring

状态码描述。

示例值:The SMS Send Request was accepted
Fromstring

发送方标识,返回传入的 Sender ID。

示例值:Alicloud321
MessageIdListstring

发送成功的消息 ID。

示例值:["123****","124****"]
SuccessCountstring

成功发送条数。

示例值:2
变更历史
变更时间变更内容概要操作
2024-10-17
新增请求参数ChannelId
2023-06-27
新增请求参数ValidityPeriod