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