请求地址
https://open.ucpaas.com/ol/sms/sendsms_batch
请求方式
请求方式:POST,支持HTTPS
注意:为降低遭受恶意攻击的风险,请遵循下述安全策略使用短信发送接口
1、为防止请求被拦截并伪造攻击,请勿将该接口直接用于前端开发。如需由前端发送短信,请对本接口进行二次封装并且强制要求二次验证(例如:图形验证码、滑块验证);
2、在功能上线前,进入开发者控制后台绑定服务器IP白名单,以禁止其法IP发送请求攻击;
3、使用https协议,减少信息被拦截和伪造的风险;
JSON 请求示例
参数 | 类型 | 约束 | 描述 | 示例 |
---|---|---|---|---|
sid | String | 必填 | 用户的账号唯一标识“Account Sid”,在开发者控制台获取(位置) | 39467b989d087c2d92c6132184a365d8 |
token | String | 必填 | 用户密钥“Auth Token”,在开发者控制台获取(位置) | 23f757bad208226ec301e117e40006ed |
appid | String | 必填 | 创建应用时系统分配的唯一标示(位置) | 2d92c6132139467b989d087c84a365d8 |
templateid | String | 必填 | 创建短信模板时系统分配的唯一标示,可在后台短信产品→选择接入的应用→短信模板-模板ID,查看该模板ID(位置) | 154501 |
param | String | 选填 | 模板中的替换参数,如该模板不存在参数则无需传该参数或者参数为空,如果有多个参数则需要写在同一个字符串中,以英文逗号分隔 (如:“a,b,c”),参数中不能含有特殊符号“【】”和“,” | 87828,3 |
mobile | String | 必填 | 接收的手机号,多个手机号码以英文逗号分隔 (如:“18011984299,18011801180”),最多单次支持100个号码,如果号码重复,则只发送一条 | 18011984299,18011801180 |
uid | String | 选填 | 用户透传ID,随状态报告返回 | 2d92c6132139467b989d087c84a365d8 |
{ "sid":"39467b989d087c2d92c6132184a365d8", "token":"23f757bad208226ec301e117e40006ed", "appid":"2d92c6132139467b989d087c84a365d8", "templateid":"154501", "param":"87828,3", "mobile":"18011984299", "uid":"2d92c6132139467b989d087c84a365d8" }
JSON 响应示例
参数 | 类型 | 描述 | 示例 |
---|---|---|---|
code | String | 状态码 | 000000 |
msg | String | 对应状态码的信息 | 例如:“OK” |
count_sum | String | 总计费条数 | 3 |
create_date | String | 创建时间,格式YYYY-MM-DD hh:mm:ss | 2017-08-28 19:08:28 |
report | String | 响应数组 | |
code | String | 状态码 | 0 |
msg | String | 对应状态码的信息 | 例如:“OK” |
smsid | String | 短信唯一id | f96f79240e372587e9284cd580d8f953 |
mobile | String | 手机号码 | 18088888888 |
uid | String | 请求时透传的uid | 2d92c6132139467b989d087c84a365d8 |
count | String | 计费条数 | 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" } ] }