发送短信到中国香港、中国澳门、中国台湾以及中国境外地区。
接口说明
使用说明
SendMessageToGlobe接口不支持往中国内地发送短信。
QPS 限制
本接口的单用户（同一个阿里云账号）QPS 限制为 2000 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
To | string | 是 | 接收方号码。号码格式为：国际区号+号码。例如：8521245567****。 电话代码详情，请参见电话代码。 说明 SendMessageToGlobe 接口不支持往中国内地发送短信。 | 8521245567**** |
From | string | 否 | 发送方号码。支持 Sender ID 的发送，只允许数字、字母，含有字母标识最长 11 位，纯数字标识支持 15 位。 | Alicloud321 |
Message | string | 是 | 短信的内容。 | Hello |
TaskId | string | 否 | 任务 ID。长度不超过 255 个字符。可以在短信回执消息体的 TaskId 字段获取。 | 123****789 |
ValidityPeriod | long | 否 | 短信有效时长，单位：秒。 | 600 |
ChannelId | string | 否 | 通道 ID。 | 3790 |
返回参数
名称 | 类型 | 描述 | 示例值 |
ResponseCode | string | 短信提交状态码。 | OK |
NumberDetail | object | 号码明细。 | |
Carrier | string | 号码所属的运营商网络。 | CMI |
Region | string | 号码所属地区。 | HongKong |
Country | string | 号码所属国家。 | China |
RequestId | string | 请求 ID。 | F655A8D5-B967-440B-8683-DAD6FF8DE990 |
Segments | string | 短信计费条数。 | 1 |
ResponseDescription | string | 短信提交状态码描述。 | The SMS Send Request was accepted |
From | string | 发送方号码，返回传入的 Sender ID。 | Alicloud321 |
To | string | 接收方号码。 | 1380000**** |
MessageId | string | 消息 ID。 | 1008030300**** |
示例
正常返回示例
JSON格式
{
"ResponseCode": "OK",
"NumberDetail": {
"Carrier": "CMI",
"Region": "HongKong",
"Country": "China"
},
"RequestId": "F655A8D5-B967-440B-8683-DAD6FF8DE990",
"Segments": "1",
"ResponseDescription": "The SMS Send Request was accepted",
"From": "Alicloud321",
"To": "1380000****",
"MessageId": "1008030300****"
}