单一发短信接口

描述

请求参数

名称 类型 是否必须 描述

Action String 必须 操作接口名，系统规定参数，取值：SingleSendSms

SignName String 必须 管理控制台中配置的短信签名（状态必须是验证通过）

TemplateCode String 必须 管理控制台中配置的审核通过的短信模板的模板CODE（状态必须是验证通过）

RecNum String 必须 目标手机号，多个手机号可以逗号分隔

ParamString String 必选 短信模板中的变量；数字需要转换为字符串；个人用户每个变量长度必须小于15个字符。 例如:短信模板为：“接受短信验证码${no}”,此参数传递{“no”:”123456”}，用户将接收到[短信签名]接受短信验证码123456

 

返回参数

 

错误码

错误代码 描述 Http状态码 语义

InvalidDayuStatus.Malformed

The specified dayu status is wrongly formed.

400

账户短信开通状态不正确

 

InvalidSignName.Malformed

The specified sign name is wrongly formed.

400

短信签名不正确或签名状态不正确

 

InvalidTemplateCode.MalFormed

The specified templateCode is wrongly formed.

400

短信模板Code不正确或者模板状态不正确

 

InvalidRecNum.Malformed

The specified recNum is wrongly formed.

400

目标手机号不正确，单次发送数量不能超过100

 

InvalidParamString.MalFormed

The specified paramString is wrongly formed.

400

短信模板中变量不是json格式

 

InvalidParamStringTemplate.Malformed

The specified paramString and template is wrongly formed.

400

短信模板中变量与模板内容不匹配

 

InvalidSendSms Frequency

limit reaches.

404

触发业务流控

 

InvalidDayu.Malformed

null

400

变量不能是url，可以将变量固化在模板中

 

 

SignatureDoesNotMatch

翻译过来是签名错误

可能是参数的问题

 

示例

请求示例

1
2
3
4
5
6
https://sms.aliyuncs.com/?Action=SingleSendSms
&SignName=阿里云短信服务
&TemplateCode=SMS_1595010
&RecNum=13011112222   
&ParamString={"no":"123456"}
&<公共请求参数>

 

注：请求参数一定不要落下“公共请求参数”

返回示例

1
2
3
4
5
6
7
8
XML格式
<SingleSendSmsResponse>
    <RequestId>12D086F6-8F31-4658-84C1-006DED011A85</RequestId>
</SingleSendSmsResponse>
JSON示例
{
  "RequestId": "12D086F6-8F31-4658-84C1-006DED011A85"
}