SendMessageToGlobe

调用SendMessageToGlobe接口发送短信到美国、加拿大和新加坡,Sender ID需要注册。

QPS限制

本接口的单用户QPS限制为1000次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。

请求参数

名称

类型

是否必选

示例值

描述

Action

String

SendMessageToGlobe

操作接口名,系统规定参数。取值:SendMessageToGlobe

Message

String

Hello

短信的完整内容。

说明

美国、加拿大需要填写报备的内容。

To

String

"6212345****01"

接收短信号码。号码格式为:国际区号+号码。例如:"6212345****01"。

From

String

Alicloud

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

说明
  • 美国、加拿大需要填写10 DLC注册后运营商提供的Sender ID。

  • 新加坡需填写在IMDA完成SSIR注册的Sender ID。

Type

String

OTP

短信类型,取值:

  • OTP:验证码

  • NOTIFY:短信通知

  • MKT:推广短信

返回数据

名称

类型

示例值

描述

From

String

Alicloud

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

MessageId

String

1008030xxx3003

短信发送ID。

NumberDetail

Struct

Country:Hongkong, China

Region:Hongkong

Carrier:CMI

号码明细。

Carrier

String

CMI

号码所属的运营商网络。

Country

String

Hongkong, China

号码所属国家。

Region

String

HongKong

号码所属地区。

Segments

String

1

短信计费条数。

To

String

"6212345****01"

接收号码。

示例

请求示例

http(s)://dysmsapi.aliyuncs.com/?Action=SendMessageToGlobe
&Message=xxxx
&To="6212345****01"
&Type=OTP
&From=Alicloud
&<公共请求参数>

正常返回示例

XML 格式

<SendMessageToGlobeResponse>
      <From>Alicloud</From>
      <MessageId>1008030xxx3003</MessageId>
      <NumberDetail>
            <Carrier>CMI</Carrier>
            <Country>Hongkong,China</Country>
            <Region>HongKong</Region>
      </NumberDetail>
      <RequestId>F655A8D5-B967-440B-8683-DAD6FF8DE990</RequestId>
      <Segments>1</Segments>
      <To>6212345****01</To>
</SendMessageToGlobeResponse>

JSON 格式

{
    "From": "Alicloud",
    "MessageId": "1008030xxx3003",
    "NumberDetail": {
        "Carrier": "CMI",
        "Country": "Hongkong,China",
        "Region": "HongKong"
        },
    "RequestId": "F655A8D5-B967-440B-8683-DAD6FF8DE990",
    "Segments": "1",
    "To": "6212345****01"
}

错误码

访问错误中心查看更多错误码。