递归火山软件开发平台

标题: 火山PC阿里云短xin接口对接-调用-排错全攻略 [打印本页]

作者: 1185907650 时间: 2021-8-23 10:20
标题: 火山PC阿里云短xin接口对接-调用-排错全攻略

今天给大家分享下阿里云短xin接口对接的流程和调用方法.

(图片来源地址https://help.aliyun.com/document_detail/59210.html 同时这个链接也是阿里官方短xin平台的使用指引)

第一步:入驻阿里云

第二步开通短xin服务

(https://dysms.console.aliyun.com/dysms.htm 打开此连接进行开通,注意个人用户可以申请100条免费的测试套餐,测试后,后期可以根据个人需要进行相应付费套餐购买)

第三步申请AccessKey

咱们需要通过火山PC调用阿里云的http接口发送短xin就必须申请AccessKEY,打开RAM控制台申请

注意创建完毕后,需要添加sms短xin发送的权限,不然是无法正常使用的,生成的AccessKey ID和AccessKey Secret 请妥善保存,不要泄露给他人使用

第四步创建签名和模板

短xin签名是短xin服务提供的一种快捷、方便的个性化签名方式。当发送短xin时，短xin平台会根据设置，在短xin内容里附加个性签名，再发送给指定手机号码。

短xin服务可以根据用户属性创建符合自身属性的签名，一般建议设置为账号主体所在机构的全称或简称。当发送短xin时，短xin平台会将已审核通过的个性化短xin签名添加到短xin内容中，再发送给短xin接收方。

短xin模版，即具体发送的短xin内容，可以支持**、短xin通知、推广短xin三种模式。**和短xin通知，通过变量替换实现个性短xin定制。

注意:短xin签名和短xin模版需要审核通过后才可以使用。

登录控制台短xin服务,在快捷操作-添加签名和添加模板进行相关操作

新建签名,按照提示自己填写相关信息即可,注意不能乱填必须是有已经上线备案过的网站和APP才能审核通过

下面看下模板,我们以本次需要操作的模板为例(通用模板)

模板申请通过后会有一个模板CODE这个调用时候是需要的

简单说下短xin中的变量格式就是 ${变量名1} ${变量名2} 在短xin允许的场景可以有多个变量,这个变量会替换成我们调用接口提交时的实际参数变量的类型可以数字,字母或中文在设置模板时可以自己定义.

另请注意,如果单纯的**,那么APP或网站必须有这个接口,才能审核通过,官方会查看申请的调用接口,否则无法通过

好了,经过上面的步骤我们已经完成准备工作,下面我们就以调用重置密码的短xin模板为例进行火山PC调用的说明:

所需库:利快云FOF套件

调用代码非常简单:

注意点各种key替换成自己的

发送通用模板的JSON数据一定要用JSON对象处理千万不要字符串形式,会有问题的

手机收到的短xin结果

错误处理:

在发送短xin是会返回接口的消息来确认发送是否成功,成功就会返回OK,若是失败就会返回具体的错误码

如图所示就是返回的错误消息,我们可以看到具体的错误内容是Specified parameter Version is not valid 我们根据错误提示在阿里官方查找错误

我们进一步查看

发现是api的Version参数问题,这样处理后就发送正常

源码下载地址：

作者: mmmww 时间: 2021-8-23 11:51
:噜阿噜

作者: ruanjian 时间: 2021-8-23 12:07
谢谢分享！

作者: 1185907650 时间: 2021-8-24 18:03
日常一顶

作者: 1185907650 时间: 2021-8-28 17:10
日常一顶

作者: sq2103 时间: 2021-11-8 22:56
楼主辛苦了，谢谢楼主，感谢楼主分享，楼主好人一生平安！！！

作者: 7325701 时间: 2022-8-30 08:18
发现是api的Version参数问题,这样处理后就发送正常

作者: shentantan 时间: 2022-11-16 08:57
谢谢分享！

欢迎光临递归火山软件开发平台 (https://bbs.voldp.com/)