火山PC阿里云短xin接口对接-调用-排错全攻略

1185907650

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

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

第一步:入驻阿里云

(打开https://account.aliyun.com/register/register.htm 连接进行注册)

第二步 开通短xin服务

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

第三步 申请AccessKey

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

(图片来自https://help.aliyun.com/document_detail/53045.html)

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

第四步 创建签名和模板

(图摘自阿里巴巴https://help.aliyun.com/document_detail/59210.html)

签名官方帮助(https://help.aliyun.com/document_detail/108072.html)

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

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

模板官方帮助(https://help.aliyun.com/document_detail/108086.html)

短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参数问题,这样处理后就发送正常

阿里API错误码页面:https://help.aliyun.com/document_detail/101346.html

源码下载地址：

游客，如果您要查看本帖隐藏内容请回复

mmmww

:噜阿噜

ruanjian

谢谢分享！

1185907650

日常一顶

1185907650

日常一顶

sq2103

楼主辛苦了，谢谢楼主，感谢楼主分享，楼主好人一生平安！！！

7325701

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

shentantan

谢谢分享！