这里会显示出您选择的修订版和当前版本之间的差别。
两侧同时换到之前的修订记录 前一修订版 | |||
短信:addsmstemplate [2017/11/09 02:34] admin [增加模板] |
短信:addsmstemplate [2024/04/26 04:03] (当前版本) |
||
---|---|---|---|
行 3: | 行 3: | ||
**请求地址** | **请求地址** | ||
<code> | <code> | ||
- | https://open.ucpaas.com/ol/sms/addsmstemplate | + | http://open2.ucpaas.com/sms-server/addsmstemplate |
</code> | </code> | ||
行 10: | 行 10: | ||
<html><p style="font-size;28px; color:red ;"> | <html><p style="font-size;28px; color:red ;"> | ||
- | <b>注意:如需创建会员营销类模板,需要先升级为企业认证用户,或购买指定套餐包</b><br> | + | <b>注意:为降低遭受恶意攻击的风险,请遵循下述安全策略使用短信发送接口</b><br> |
+ | 1、为防止请求被拦截并伪造攻击,请勿将该接口直接用于前端开发。如需由前端发送短信,请对本接口进行二次封装并且强制要求二次验证(例如:图形验证码、滑块验证);<br> | ||
+ | 2、在功能上线前,进入开发者控制后台绑定服务器IP白名单,以禁止其法IP发送请求攻击;<br> | ||
+ | 3、使用https协议,减少信息被拦截和伪造的风险; | ||
</html> | </html> | ||
**JSON 请求示例**\\ | **JSON 请求示例**\\ | ||
^参数 ^类型 ^约束 ^描述 ^示例 ^ | ^参数 ^类型 ^约束 ^描述 ^示例 ^ | ||
- | |sid|String|必填|用户的账号唯一标识“Account Sid”,在开发者控制台获取([[短信:authentication_sms#Token 和 sid|位置]])|39467b989d087c2d92c6132184a365d8| | + | |clientid|String|必填|用户的账号唯一标识“clientid”,在开发者控制台获取(账号管理->子账号管理->子账号id)|bxxxxx9| |
- | |token|String|必填|用户密钥“Auth Token”,在开发者控制台获取([[短信:authentication_sms#Token 和 sid|位置]])|23f757bad208226ec301e117e40006ed| | + | |password|String|必填|用户密钥“password”,在开发者控制台获取(账号管理->子账号管理->接口管理(密码md5 32位小写))|c719c6dxxxxxxxxxa50a7490ee05| |
- | |appid|String|必填|创建应用时系统分配的唯一标示([[短信:authentication_sms#appid|位置]])|2d92c6132139467b989d087c84a365d8| | + | |smstype|String|必填|模板属性(请提交对应的类型以免审核拒绝)|0:通知短信 4:验证码短信 5:会员营销| |
- | |type|String|必填|短信类型:0:通知短信、5:会员服务短信(需企业认证)、4:验证码短信(此类型content内必须至少有一个参数{1})|4| | + | |sign|String|必填|限2-12个汉字、英文字母和数字| |
- | |template_name|String|选填|短信模板名称,限6个汉字或20个数字、英文字、符号|注册验证| | + | |content|String|必填|您的验证码是{},请在5分钟输入| |
- | |autograph|String|必填|短信签名,建议使用公司名/APP名/网站名,限2-12个汉字、英文字母和数字,不能纯数字|云之讯| | + | |
- | |content|String|必填|短信内容,最长500字,不得含有【】符号,可支持输入参数,参数示例“{1}”、“{2}”|您的注册验证码是{1}| | + | |
<code json> | <code json> | ||
{ | { | ||
- | "sid":"39467b989d087c2d92c6132184a365d8", | + | "clientid":"bxxxxx9", |
- | "token":"23f757bad208226ec301e117e40006ed", | + | "password" : "c719c6dxxxxxxxxxa50a7490ee05", |
- | "appid":"2d92c6132139467b989d087c84a365d8", | + | "smstype":"4", |
- | "type":"4", | + | "sign" : "签名", |
- | "templateName":"注册验证", | + | "content" : "内容" |
- | "autograph":"云之讯", | + | } |
- | "content":"您的注册验证码是{1}" | + | |
- | } | + | |
</code> | </code> | ||
行 38: | 行 36: | ||
^参数 ^类型 ^描述 ^示例 ^ | ^参数 ^类型 ^描述 ^示例 ^ | ||
|code|String|状态码|0| | |code|String|状态码|0| | ||
- | |msg|String|对应状态码的信息|例如:"模板短信整体长度不能超过500位"| | + | |msg|String|对应状态码的信息|例如:"成功"| |
- | |templateid|String|模板ID|62222| | + | |
- | |create_date|String|创建时间,格式YYYY-MM-DD hh:mm:ss|2017-08-28 19:08:28| | + | |
<code json> | <code json> | ||
{ | { | ||
- | "code":"0", | + | "code":0, |
- | "msg":"OK", | + | "msg" : "成功" |
- | "templateid":"62222", | + | } |
- | "create_date":"2017-08-28 19:08:28" | + | |
- | } | + | |
</code> | </code> | ||
- | =====相关资料===== | ||
- | [[:sms_sdk|SDK下载]] [[:error_code|返回码]] |