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