SendBatchSms_短信服务_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

基本信息

  • 本接口主要用于向多个手机号发送短信,支持发送不同签名、同一模板、不同模板变量的短信,单次调用最多支持 100 个手机号。
  • 服务接入点 (Endpoint):全局接入点域名为dysmsapi.aliyuncs.com。请参见服务接入点 ,根据您的使用地域,选择对应的接入点地址。

快速调用

注意事项

  • 国内短信服务超时时间建议设置为≥1S;发生超时失败的情况时,建议查看回执状态后再判断是否重试。超时和重试的相关设置,请参见超时机制重试机制
  • 国内短信、国际短信及多媒体短信目前均不支持幂等的能力,请您做好幂等控制,防止因多次重试而导致的重复操作问题。
  • 发送短信为计费接口,国内短信按照运营商回执状态计费,调用 SendBatchSms 提交成功但运营商回执失败的短信不计费,计费详情请参见计费概述

QPS 限制

本接口的单用户 QPS 限制为 5000/秒。超过限制,API 调用将会被限流,请合理使用。

流控信息

请求速率为5000/1(s)。更多流控信息,请前往配额中心查看

授权信息

当前云产品暂无权限信息透出。

请求参数

字段名称字段详情
PhoneNumberJsonstring

接收短信的手机号码。手机号码格式:展开详情

示例值:["1590000****","1350000****"]
SignNameJsonstring

短信签名名称,签名数量需与手机号码数量一致。展开详情

示例值:["阿里云","阿里巴巴"]
TemplateCodestring

短信模板 Code。国内短信模板和国际短信模板不可以混用。展开详情

示例值:SMS_15255****参考取值来源:
    UpdateSmsTemplate
    CreateSmsTemplate
    QuerySmsTemplateList
TemplateParamJsonstring

短信模板变量对应的实际值。当您选择的模板内含有变量时,此参数必填。展开详情

示例值:[{"name":"TemplateParamJson"},{"name":"TemplateParamJson"}]
SmsUpExtendCodeJsonstring

上行短信扩展码,JSON 数组格式。展开详情

示例值:["90999","90998"]
OutIdstring

外部流水扩展字段,长度小于 256 的字符串。展开详情

示例值:abcdefg

返回参数

字段名称字段详情
Codestring

请求状态码。展开详情

示例值:OK
Messagestring

是否调用接口成功的描述。

示例值:OK
BizIdstring

发送回执 ID。展开详情

示例值:9006197469364984400
RequestIdstring

请求 ID。

示例值:F655A8D5-B967-440B-8683-DAD6FF8D230E

返回示例

变更历史

变更时间变更内容概要操作
2022-09-29
新增请求参数OutId
2022-08-11
变更请求参数PhoneNumberJson
变更请求参数SignNameJson
变更请求参数TemplateParamJson
变更请求参数SmsUpExtendCodeJson

相关示例

通过 SendBatchSms 批量发送短信并查询发送的结果
2021-03-12