发送短信接口
单一发短信接口
描述
请求参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| 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，可以将变量固化在模板中 |
示例
请求示例
https://sms.aliyuncs.com/?Action=SingleSendSms
&SignName=阿里云短信服务
&TemplateCode=SMS_1595010
&RecNum=13011112222
&ParamString={"no":"123456"}
&<公共请求参数>
注：请求参数一定不要落下“公共请求参数”
返回示例
XML格式
<SingleSendSmsResponse>
<RequestId>12D086F6-8F31-4658-84C1-006DED011A85</RequestId>
</SingleSendSmsResponse>
JSON示例
{
"RequestId": "12D086F6-8F31-4658-84C1-006DED011A85"
}