用户工具

短信:sendsms_batch

指定模板群发

请求地址

https://open.ucpaas.com/ol/sms/sendsms_batch								

请求方式
请求方式:POST,支持HTTPS

注意:为降低遭受恶意攻击的风险,请遵循下述安全策略使用短信发送接口
1、为防止请求被拦截并伪造攻击,请勿将该接口直接用于前端开发。如需由前端发送短信,请对本接口进行二次封装并且强制要求二次验证(例如:图形验证码、滑块验证);
2、在功能上线前,进入开发者控制后台绑定服务器IP白名单,以禁止其法IP发送请求攻击;
3、使用https协议,减少信息被拦截和伪造的风险;

JSON 请求示例

参数 类型 约束 描述 示例
sidString必填用户的账号唯一标识“Account Sid”,在开发者控制台获取(位置39467b989d087c2d92c6132184a365d8
tokenString必填用户密钥“Auth Token”,在开发者控制台获取(位置23f757bad208226ec301e117e40006ed
appidString必填创建应用时系统分配的唯一标示(位置2d92c6132139467b989d087c84a365d8
templateidString必填创建短信模板时系统分配的唯一标示,可在后台短信产品→选择接入的应用→短信模板-模板ID,查看该模板ID(位置154501
paramString选填模板中的替换参数,如该模板不存在参数则无需传该参数或者参数为空,如果有多个参数则需要写在同一个字符串中,以英文逗号分隔 (如:“a,b,c”),参数中不能含有特殊符号“【】”和“,”87828,3
mobileString必填接收的手机号,多个手机号码以英文逗号分隔 (如:“18011984299,18011801180”),最多单次支持100个号码,如果号码重复,则只发送一条18011984299,18011801180
uidString选填用户透传ID,随状态报告返回2d92c6132139467b989d087c84a365d8
{
 "sid":"39467b989d087c2d92c6132184a365d8",
 "token":"23f757bad208226ec301e117e40006ed",
 "appid":"2d92c6132139467b989d087c84a365d8",
 "templateid":"154501",
 "param":"87828,3",
 "mobile":"18011984299",
 "uid":"2d92c6132139467b989d087c84a365d8"
}

JSON 响应示例

参数 类型 描述 示例
codeString状态码000000
msgString对应状态码的信息例如:“OK”
count_sumString总计费条数3
create_dateString创建时间,格式YYYY-MM-DD hh:mm:ss2017-08-28 19:08:28
reportString响应数组
codeString状态码0
msgString对应状态码的信息例如:“OK”
smsidString短信唯一idf96f79240e372587e9284cd580d8f953
mobileString手机号码18088888888
uidString请求时透传的uid2d92c6132139467b989d087c84a365d8
countString计费条数1
{
  "code":"000000",
  "msg":"OK",
  "count_sum":"3",
  "create_date":"2017-08-28 19:08:28",
  "uid":"",
  "report":[
     {
       "code":"0",
       "msg":"OK",
       "smsid":"f96f79240e372587e9284cd580d8f953",
       "mobile":"18011984299",
       "count":"1"
     },{
       "code":"1014",
       "msg":"手机号码格式错误",
       "smsid":"cdawqes40e372587e9284cd580d8f953",
       "mobile":"1801198429",
       "count":"1"
     },{
       "code":"1005",
       "msg":"对同个手机号码发送频率超过限制",
       "smsid":"dadwewa2372587dse9284cd580d8f953",
       "mobile":"18011984299",
       "count":"1"
     }
          ]
}					

相关资料


页面工具