短信发送
购买接口
首先我们需要找到一个短信发送接口,市面上有很多类似的第三方接口,大家可以根据需要自行选择。我们以下面给出的接口为例,讲解如何在简道云的前端事件中配置:
我们可以先购买一个 0 元的免费体验版本,然后可以在控制台-云市场-已买到的服务号中看到我们的 AppCode,这是用来调用接口的凭证(后面会用到)。
接口分析
然后我们回到刚才接口的界面,详细地分析下这个接口:
请求方式:POST
返回类型:JSON
接口的URL:http://toushitz.market.alicloudapi.com/ts/notifySms
请求的Headers:(服从阿里云云市场的标准鉴权方式):Authorization: APPCODE + 半角空格 + 你自己的APPCODE
请求的参数(Query):
名称 | 类型 | 是否必须 | 描述 |
mobile | STRING | 必选 | 需发送的手机号码 |
param | STRING | 可选 | 模板中变量参数名:参数值,有多个时使用","隔开,例如:code:1234,amount:100 |
tpl_id | STRING | 可选 | 模板id |
虽然是 POST 请求,但是请求参数是 Query 类型,所以请求的参数需要以 URL 传参形式拼接在 URL 后面。
例如: http://toushitz.market.alicloudapi.com/ts/notifySms?mobile=xxxx&tpl_id=xxxx¶m=xxxxx。
另外,涉及到短信的接口会存在一个比较特殊的地方:发送短信的内容需要由短信模板来规定。
我们提前申请好了一个短信模板,格式如下,其中 name 和 code 是我们需要在前端事件中传递的内容。
配置前端事件
分析完了接口,我们下面正式进入接口的配置环节。首先在表单中添加好触发字段(该字段的值改变就会去触发调用接口) ,由于我们这里是短信发送,所以设置一个单选按钮,其标题为「发送短信」(选择隐藏标题),唯一的选项为「确认发送短信」,当使用者点击这个按钮即触发发送短信事件。
按照上面的分析:
- 选择请求类型为: POST
- URL为:http://toushitz.market.alicloudapi.com/ts/notifySms
我们需要通过 URL 传递参数,所以需要在 URL 后面加上 ?mobile=【插入手机号字段】&tpl_id=【插入和购买接口的客服申请的模版号】¶m=【插入模板中涉及的参数】。
以我们上面申请的模板为例,最终的URL地址就为:http://toushitz.market.alicloudapi.com/ts/notifySms?mobile=手机号&tpl_id=xxxx¶m=name:称呼,code:短信参数。
然后我们进入 Header/Body 的设置:
Header为Authorization: APPCODE + 半角空格 + 你自己的APPCODE:
设置返回值:
由于短信发出去即可,不需要把返回值填入表单,因此不需要设置返回值。