短信发送

购买接口

首先我们需要找到一个短信发送接口,市面上有很多类似的第三方接口,大家可以根据需要自行选择。我们以下面给出的接口为例,讲解如何在简道云的前端事件中配置:

我们可以先购买一个 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&param=xxxxx。

另外,涉及到短信的接口会存在一个比较特殊的地方:发送短信的内容需要由短信模板来规定。

我们提前申请好了一个短信模板,格式如下,其中 name 和 code 是我们需要在前端事件中传递的内容。

配置前端事件

分析完了接口,我们下面正式进入接口的配置环节。首先在表单中添加好触发字段(该字段的值改变就会去触发调用接口) ,由于我们这里是短信发送,所以设置一个单选按钮,其标题为「发送短信」(选择隐藏标题),唯一的选项为「确认发送短信」,当使用者点击这个按钮即触发发送短信事件。

按照上面的分析:

  • 选择请求类型为: POST
  • URL为:http://toushitz.market.alicloudapi.com/ts/notifySms

我们需要通过 URL 传递参数,所以需要在 URL 后面加上 ?mobile=【插入手机号字段】&tpl_id=【插入和购买接口的客服申请的模版号】&param=【插入模板中涉及的参数】。

以我们上面申请的模板为例,最终的URL地址就为:http://toushitz.market.alicloudapi.com/ts/notifySms?mobile=手机号&tpl_id=xxxx&param=name:称呼,code:短信参数。

然后我们进入 Header/Body 的设置:

Header为Authorization: APPCODE + 半角空格 + 你自己的APPCODE:

设置返回值:

由于短信发出去即可,不需要把返回值填入表单,因此不需要设置返回值。

文档内容是否对您有帮助?
有帮助
没帮助没帮助
如需获取即时帮助,请联系技术支持
咨询
扫码领取100+零代码资料简道云官方微信号400-111-0890
图标在线咨询
立即体验