SendBatchSms - 短信服务

SendBatchSms接口是短信批量发送接口，支持在一次请求中分别向多个不同的手机号码发送不同签名的短信。手机号码等参数均为JSON格式，字段个数相同，一一对应，短信服务根据字段在JSON中的顺序判断发往指定手机号码的签名。

如果您需要往多个手机号码中发送同样签名的短信，请使用SendSms接口实现。

调用该接口发送短信时，请注意：

发送短信会根据发送量计费，价格请参见计费说明。
在一次请求中，最多可以向100个手机号码分别发送短信。

说明 SendBatchSms接口群发整体请求量限定在128k以内。

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	否	SendBatchSms	系统规定参数。取值：SendBatchSms。
PhoneNumberJson	String	是	["1590000**","1350000**"]	接收短信的手机号码，JSON数组格式。手机号码格式：国内短信：+/+86/0086/86或无任何前缀的11位手机号码，例如1590000**。国际/港澳台消息：国际区号+号码，例如852000012**。说明验证码类型短信，建议使用接口SendSms单独发送。
SignNameJson	String	是	["阿里云","阿里巴巴"]	短信签名名称，JSON数组格式。请在控制台国内消息或国际/港澳台消息页面中的签名管理页签下签名名称一列查看。说明必须是已添加、并通过审核的短信签名；且短信签名的个数必须与手机号码的个数相同、内容一一对应。
TemplateCode	String	是	SMS_152550005	短信模板CODE。请在控制台国内消息或国际/港澳台消息页面中的模板管理页签下模板CODE一列查看。说明必须是已添加、并通过审核的模板CODE；且发送国际/港澳台消息时，请使用国际/港澳台短信模版。
TemplateParamJson	String	否	[{"name":"TemplateParamJson"},{"name":"TemplateParamJson"}]	短信模板变量对应的实际值，JSON格式。说明如果JSON中需要带换行符，请参照标准的JSON协议处理；且模板变量值的个数必须与手机号码、签名的个数相同、内容一一对应，表示向指定手机号码中发对应签名的短信，且短信模板中的变量参数替换为对应的值。
SmsUpExtendCodeJson	String	否	["90999","90998"]	上行短信扩展码，JSON数组格式。无特殊需要此字段的用户请忽略此字段。

返回数据


名称	类型	示例值	描述
BizId	String	900619746936498440^0	发送回执ID，可根据该ID在接口QuerySendDetails中查询具体的发送状态。
Code	String	OK	请求状态码。返回OK代表请求成功。其他错误码，请参见错误码列表。
Message	String	OK	状态码的描述。
RequestId	String	F655A8D5-B967-440B-8683-DAD6FF8D****	请求ID。

示例

请求示例

http(s)://dysmsapi.aliyuncs.com/?Action=SendBatchSms
&PhoneNumberJson=["1590000****","1350000****"]
&SignNameJson=["阿里云","阿里巴巴"]
&TemplateCode=SMS_152550005
&<公共请求参数>

正常返回示例

XML格式

<SendBatchSmsResponse>
  <Message>OK</Message>
  <RequestId>F655A8D5-B967-440B-8683-DAD6FF8D****</RequestId>
  <Code>OK</Code>
  <BizId>900619746936498440^0</BizId>
</SendBatchSmsResponse>

JSON格式

{
    "Message": "OK",
    "RequestId": "F655A8D5-B967-440B-8683-DAD6FF8D****",
    "Code": "OK",
    "BizId": "900619746936498440^0"
}

错误码

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

说明旧版API已不做更新，API文档请参考本文，如需参考旧版，请参见API参考。