调用SendMessageToGlobe接口发送短信到国际地区。

QPS限制

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

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String SendMessageToGlobe

系统规定参数。取值:SendMessageToGlobe

To String 861245567****

接收方号码。号码格式为:国际区号+号码。例如:861245567****。

From String Alicloud

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

Message String Hello

短信的内容。

TaskId String 123****789

任务ID。长度不超过255个字符。

返回数据

名称 类型 示例值 描述
ResponseCode String OK

短信提交状态码。

NumberDetail Object

号码明细。

Carrier String CMI

号码所属的运营商网络。

Region String HongKong

号码所属地区。

Country String Hongkong, China

号码所属国家。

RequestId String F655A8D5-B967-440B-8683-DAD6FF8DE990

请求ID。

Segments String 1

短信计费条数。

ResponseDescription String The SMS Send Request was accepted

短信提交状态码描述。

From String Alicloud

发送方号码,返回传入的SenderId。

To String "123"

接收方号码。

MessageId String 1008030300****

短信发送ID。

示例

请求示例

http(s)://dysmsapi.ap-southeast-1.aliyuncs.com/?Action=SendMessageToGlobe
&To=861245567****
&From=Alicloud
&Message=Hello
&TaskId=123****789
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<SendMessageToGlobeResponse>
    <ResponseCode>OK</ResponseCode>
    <NumberDetail>
        <Carrier>CMI</Carrier>
        <Region>HongKong</Region>
        <Country>Hongkong, China</Country>
    </NumberDetail>
    <RequestId>F655A8D5-B967-440B-8683-DAD6FF8DE990</RequestId>
    <Segments>1</Segments>
    <ResponseDescription>The SMS Send Request was accepted</ResponseDescription>
    <From>Alicloud</From>
    <To>"123"</To>
    <MessageId>1008030300****</MessageId>
</SendMessageToGlobeResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "ResponseCode" : "OK",
  "NumberDetail" : {
    "Carrier" : "CMI",
    "Region" : "HongKong",
    "Country" : "Hongkong, China"
  },
  "RequestId" : "F655A8D5-B967-440B-8683-DAD6FF8DE990",
  "Segments" : "1",
  "ResponseDescription" : "The SMS Send Request was accepted",
  "From" : "Alicloud",
  "To" : "123",
  "MessageId" : "1008030300****"
}

错误码

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