短信服务开发

小咪咪 2022-05-11 03:46 534阅读 0赞

**《****短信服务开发技术分享****》**

**                                 **** ——云栖**

**前言**

短信服务功能大家都很熟悉了。在很多地方都能见到，常用来一键注册或者手机登录验证等。利用短信验证码，大大降低了非法注册，很大程度上提高了用户账户的安全性。在实际的应用中，很多开发者希望能够通过短信验证的方式来与用户进行某些重要操作的确认，比如短信验证支付、订单等，你就可以在用户验证过手机号码的前提下，使用服务提供商提供的短信服务。

短信服务一般要选择106通道的。什么是106呢？106是指短信收到的特服号头三位显示的数字，移动是10657、10658，电信是10659，联通是10655。按一位知友的说法是，你可以去三大运营商直接签协议开通，但是比较麻烦，要分别承诺月消费套餐、并且要在发送的时候把号码按照三个运营商分类提交等。也可以直接委托专业的短信平台提供商，简化很多麻烦。充多少用多少，也不用担心每个月的强制消费。

目前市面上已经有非常多这类服务的服务商，有收费的，也有免费的，质量也参差不齐。当然，网上搜到的大部分提供短信服务的公司都是经过了二级、三级代理，不是与运营商直连，不单价格稍高，到达率、到达速度方面也需要考量。你要擦亮眼睛、选择一家靠谱的服务商。否则就会面临许多头疼的问题，比如：被扣量、发了收不到、延迟严重、数据被泄漏……没办法，咱们国家各个行业都有类似的问题，鱼龙混杂。服务好的，资源大的，短信运营商都是通过业务关系找到大客户，很少在网上宣传。而且大都是低调的。

关于收费，一般是按条数来计费，发送一条验证码一般收费在0.06左右，如果是直接与运营商直连的服务商，在价格上是比较有优势的，正常0.05左右一条，数量大的话还可以直接跟服务商谈，低到0.04都是有可能的。

关于免费，市面上提供免费短信验证码的服务商也有，但是个人觉得如果是在资金短缺的情况下选择使用可以，长期下来就伤体验了。我注册一个新用户，点击了发送验证码，迟迟不能收到，这是很容易失去耐心的事情。

关于签名，也就是短信里面的“【\*\*\*】”几个字。一般用户不能随意修改这个签名，因为运营商是通过这个签名来识别通道的，如果一个通道里面包含各种各样不同 的【\*\*\*】信息的话，会让这个通道变成共享通道。这样做直接带来的不好就是：前期看似速度不错，当随着用户数增多，后期有可能被认定多客户信息混发或某 个用户的恶意行为导致整个通道被监管监控，限制流速甚至会端口关停。

所以作为开发者，在选择短信服务的时候一定要谨慎一些，尽量寻找与运营商直连的，收费较低，到达速度也快，一般的短信提供商都会有免费的短信给用户测试的，可以多测试几家再决定是否使用。

**手机短信（SMS）工作原理**

SMS(Short Messaging Service)表示短信服务。简单来讲，它是在手机之间发送文字信息或从[个人计算机][Link 1]或手持设备向手机发送信息的一种方式。短信的“短”指的是文本信息的最大发送量：160个字符（字母、数字或拉丁字母中的符号）。至于其他字母，例如中文，一条短信的最大发送量为70个字符。

为什么是160个字符？手机短信可以提供像数字页那样的短量数据。为了避免使用多于标准的转发和回复操作而使系统过载，短信技术的开发人员一致同意使用一次160个字符的最大发送量。

但是160个字符的限制并不是绝对的。字符长度限制可能会因网络、手机型号以及无线运营商的差异而不同。许多手机在达到160个字符的限制时将不允许继续键入。这样您只能在发送后才可以继续键入。但是，许多服务可以自动将你所发送的短信拆分成若干个小于等于160个字符的信息块。这样，您就可以键入并发送一长条短信，只不过它会以几条短信的方式传输。

但SMS短信到底是怎么发到手机的呢？如果您已经阅读[手机工作原理][Link 2]，就会真正了解这是怎么一回事。

尽管您没有使用手机打电话，您的手机也在不停地发送和接收着信息。它通过被称为控制通道的通路与手机发射塔进行通信。这种通讯的目的是让手机系统了解自己所在的信号区域，以便在您移动时，手机可以切换到其他信号区域。每隔一段时间，手机和发射塔将交换数据包以确定一切工作正常。

控制通道也为SMS短信提供通路。当朋友给您发送SMS短信时，该条短信将以控制通道上小型数据包的形式先通过SMSC（短信业务中心），然后通过手机发射塔，再由发射塔将短信发送到手机。同理，当您发送短信时，手机将通过控制通道将短信发送到发射塔，再由发射塔传送到SMSC，最后从这个位置到达接收目标。

<table style="width:419pt;"> 
 <tbody> 
 <tr> 
 <td style="background-color:#ffffff;width:419pt;"> 手机短信（SMS）发展的历史手机短信创建于上世纪八十年代晚期，用于配合被称为<a href="http://electronics.bowenwang.com.cn/question537.htm" rel="nofollow">全球</a><a href="http://electronics.bowenwang.com.cn/question537.htm" rel="nofollow">移动通信系统（GSM）</a>的数字技术，GSM是大多数现代手机的基础。发明SMS短信的挪威工程师需要一个非常简单的短信系统，可以在手机关闭或不在服务区时发挥作用。多数资料认为，第一条SMS短信是1992年在英国发送的。 注： 
 <ol> 
 <li>SMS仅限于发送文本短信息。SMS不支持发送图片、视频或是<a href="http://electronics.bowenwang.com.cn/mp3.htm" rel="nofollow">音乐文件</a>。</li> 
 <li>强型短信服务（EMS），您可以发送格式文本、音效、小型图片及照片。</li> 
 <li>多媒体短信服务（MMS）除了可以发送文本短信息，还允许发送动画、音频和&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;视频文件。</li> 
 </ol></td> 
 </tr> 
 </tbody> 
</table>

**如何选择短信平台**

对于现在的各种平台的注册与使用，验证码短信有的重要性不言而喻。因为其广泛的实用性，除了安全性能以外，其发送速度的快慢也成为了一个需要格外注意的地方。国内各家企业都为了找到一家好的验证码短信接口平台而努力着，而想要找到一家可靠的平台，以下这些问题需要重视。

第一：检测一下短信通道质量

如果验证码短信需要经过多重服务器，那么提交到相应的运营商网关所用的时间就会较长，为此会出现延迟或是收不到的情况，而比较好的验证码短信接口平台则是与三大运营商网关直连，不需要经过多余的服务器，直接发送，速度更快。

第二：短信接口平台服务器承载能力

若是其服务器承载能力太差，那么稳定性就无法保证，同样也会出现一些人迟迟无法收到验证信息的情况，这是因为验证码短信对于平台还是有一定要求的。因而企业在选择与之合作的供应商时，一定要选择有多条备用通道的，这样在遇到大批量请求命令的时候也不会出现意外。

第三：看是不是和运营商直连

以前在没有三网合一的时候，短信发送通道都是区分运营商的，比如移动使用的是10657号段，联通是10655号段，电信则使用的是10659号段，而现在三网合一技术实行以后，统一都是使用的10690号段。无论用户是使用的哪个运营商的手机号，收到的验证码短信都是以10690开头的号码。

# **阿里云短信服务** #

# **一、产品概述** #

短信服务（Short Message Service）是阿里云为用户提供的一种通信服务的能力，支持快速发送短信验证码、短信通知等。 完美支撑双11期间2亿用户，发送6亿短信。三网合一专属通道，与工信部携号转网平台实时互联。电信级运维保障，实时监控自动切换，到达率高达99%。

# **二、产品优势** #

**1、快速稳定：快速直达，链接用户仅需3秒；三网合一专属通道；专线机房，支持大容量、高并发；99%到达率；与工信部携号转网平台实时互联；电信级运维保障，实时监控自动切换。**

**2、高并发处理：支持多个生产者和消费者并发访问同一个队列，无需特殊设置即可自由调整并发度，并能确保某条消息在取出之后的特定时间段内，无法被其他消费者获得。**

**3、消息堆积处理:通过队列对用户任务请求压力实现削峰填谷，进而降低系统峰值压力。**

**4、易开发管理:无需自行搭建消息服务，免运维提供多种语言SDK，包括JAVA、PYTHON、NET、Node.js任您选择。**

# **三、产品功能** #

**1、短信通知**

**2、短信验证码**

**3、推广短信**

# **四、短信使用流程见** #

**1、入驻阿里云**

1.1.阿里云注册入口：[点击注册页面][Link 3]

1.2.实名认证：点击进行实名认证

1.3.绑定企业支付宝：点击绑定企业支付宝

**2、开通短信服务**

2.1.开通短信服务：点击开通短信服务

2.2.进入控制台：点击查看控制台页面

**3、获取AccessKey**

3.1创建AccessKey:[ 点击创建AccessKey][AccessKey]

3.2.获取AccessKey ID和AccessKey Secret：点击查看AccessKey ID和AccessKey Secret

**4、创建签名和模板**

4.1.创建签名前查看短信规则和审核规则：[短信业务规则][Link 4]，[审核规则][Link 5]

4.2.创建短信签名：点击查看[创建短信签名][Link 6]；

4.3.创建短信模板：点击查看[创建短信模板][Link 7]；

4.4.创建推广短信：点击查看[创建推广短信][Link 8]

**5、短信接口配置**

5.1.设置访问权限控制：[点击访问权限控制][Link 9]

5.2.接口调用机制与SDK及DEMO下载：①[点击查看API签名调用机制][API]，②[点击下载SDK及DEMO][SDK_DEMO]

5.3.API文档（短信发送的入参与编写样例）：①[短信发送-JAVA][-JAVA]，②[短信发送-PHP][-PHP]，③[短信发送-Python][-Python]，④[短信发送—Node.js][Node.js]

# **五、短信接口调用错误码** #

<table style="margin-left:6.75pt;width:450.75pt;"> 
 <tbody> 
 <tr> 
 <td style="background-color:#f2f2f2;width:51.55pt;"> 错误码Code </td> 
 <td style="background-color:#f2f2f2;width:122.85pt;"> 错误提示Message </td> 
 <td style="background-color:#f2f2f2;width:276.35pt;"> 原因及建议处理方式 </td> 
 </tr> 
 <tr> 
 <td style="background-color:#ffffff;width:51.55pt;"> isp.RAM_PERMISSION_DENY </td> 
 <td style="background-color:#ffffff;width:122.85pt;"> RAM权限DENY </td> 
 <td style="background-color:#ffffff;width:276.35pt;"> 当提示RAM权限不足时，就需要给当前使用的AK对应子账号进行授权：AliyunDysmsFullAccess（权限名称）。具体权限授权详见：<a href="https://help.aliyun.com/document_detail/55764.html?spm=5176.product44282.6.548.bKZJL2" rel="nofollow">https://help.aliyun.com/document_detail/55764.html?spm=5176.product44282.6.548.bKZJL2</a> </td> 
 </tr> 
 <tr> 
 <td style="background-color:#ffffff;width:51.55pt;"> isv.OUT_OF_SERVICE </td> 
 <td style="background-color:#ffffff;width:122.85pt;"> 业务停机 </td> 
 <td style="background-color:#ffffff;width:276.35pt;"> 请先查看账户余额，若余额大于零，则请通过创建工单联系工程师处理 </td> 
 </tr> 
 <tr> 
 <td style="background-color:#ffffff;width:51.55pt;"> isv.PRODUCT_UN_SUBSCRIPT </td> 
 <td style="background-color:#ffffff;width:122.85pt;"> 未开通云通信产品的阿里云客户 </td> 
 <td style="background-color:#ffffff;width:276.35pt;"> 未开通云通信产品的阿里云客户（该AK所属的账号尚未开通云通信的服务，包括短信、语音、流量等服务）注：阿里云短信服务包含：1、消息服务 2、云通信短信服务 3、云市场短信接口，账号和短信接口不可混用。当出现此类提示报错需要检查当前AK是否已经开通阿里云云通信短信服务，如已开通消息服务，则参照消息服务文档调用接口。 </td> 
 </tr> 
 <tr> 
 <td style="background-color:#ffffff;width:51.55pt;"> isv.PRODUCT_UNSUBSCRIBE </td> 
 <td style="background-color:#ffffff;width:122.85pt;"> 产品未开通 </td> 
 <td style="background-color:#ffffff;width:276.35pt;"> 产品未订购（该AK所属的账号尚未开通当前接口的产品，如仅开通了短信服务的用户调用语音接口。），检查AK对应账号是否已开通调用接口对应的服务。短信服务开通链接：<a href="https://www.aliyun.com/product/sms" rel="nofollow">https://www.aliyun.com/product/sms</a> </td> 
 </tr> 
 <tr> 
 <td style="background-color:#ffffff;width:51.55pt;"> isv.ACCOUNT_NOT_EXISTS </td> 
 <td style="background-color:#ffffff;width:122.85pt;"> 账户不存在 </td> 
 <td style="background-color:#ffffff;width:276.35pt;"> 请确认使用的账号是否与申请的账号一致 </td> 
 </tr> 
 <tr> 
 <td style="background-color:#ffffff;width:51.55pt;"> isv.ACCOUNT_ABNORMAL </td> 
 <td style="background-color:#ffffff;width:122.85pt;"> 账户异常 </td> 
 <td style="background-color:#ffffff;width:276.35pt;"> 请确认使用的账号是否与申请的账号一致 </td> 
 </tr> 
 <tr> 
 <td style="background-color:#ffffff;width:51.55pt;"> isv.SMS_TEMPLATE_ILLEGAL </td> 
 <td style="background-color:#ffffff;width:122.85pt;"> 短信模板不合法 </td> 
 <td style="background-color:#ffffff;width:276.35pt;"> TemplateCode参数请传入审核通过的模板ID，模板见：见：<a rel="nofollow">https://dysms.console.aliyun.com/dysms.htm#/template</a> </td> 
 </tr> 
 <tr> 
 <td style="background-color:#ffffff;width:51.55pt;"> isv.SMS_SIGNATURE_ILLEGAL </td> 
 <td style="background-color:#ffffff;width:122.85pt;"> 短信签名不合法 </td> 
 <td style="background-color:#ffffff;width:276.35pt;"> SignName请传入审核通过的签名内容，签名见：<a rel="nofollow">https://dysms.console.aliyun.com/dysms.htm#/sign</a> </td> 
 </tr> 
 <tr> 
 <td style="background-color:#ffffff;width:51.55pt;"> isv.INVALID_PARAMETERS </td> 
 <td style="background-color:#ffffff;width:122.85pt;"> 参数异常 </td> 
 <td style="background-color:#ffffff;width:276.35pt;"> 对照文档，检查参数格式。例：短信查询接口SendDate日期格式yyyyMMdd，错误：2017-01-01正确：20170101 </td> 
 </tr> 
 <tr> 
 <td style="background-color:#ffffff;width:51.55pt;"> isp.SYSTEM_ERROR </td> 
 <td style="background-color:#ffffff;width:122.85pt;"> isp.SYSTEM_ERROR </td> 
 <td style="background-color:#ffffff;width:276.35pt;"> 请重试接口调用，如仍存在此情况请创建工单反馈工程师查看 </td> 
 </tr> 
 <tr> 
 <td style="background-color:#ffffff;width:51.55pt;"> isv.MOBILE_NUMBER_ILLEGAL </td> 
 <td style="background-color:#ffffff;width:122.85pt;"> 非法手机号 </td> 
 <td style="background-color:#ffffff;width:276.35pt;"> PhoneNumbers参数请传入11位国内号段的手机号码 </td> 
 </tr> 
 <tr> 
 <td style="background-color:#ffffff;width:51.55pt;"> isv.MOBILE_COUNT_OVER_LIMIT </td> 
 <td style="background-color:#ffffff;width:122.85pt;"> 手机号码数量超过限制 </td> 
 <td style="background-color:#ffffff;width:276.35pt;"> 短信接收号码,支持以英文逗号分隔的形式进行批量调用，批量上限为1000个手机号码，PhoneNumbers参数单次调用不传入过多接收号码 </td> 
 </tr> 
 <tr> 
 <td style="background-color:#ffffff;width:51.55pt;"> isv.TEMPLATE_MISSING_PARAMETERS </td> 
 <td style="background-color:#ffffff;width:122.85pt;"> 模板缺少变量 </td> 
 <td style="background-color:#ffffff;width:276.35pt;"> TemplateParam中需要以json格式字符串给使用的模板中出现的所有变量进行赋值。例：模板为：您好${name}，验证码${code} TemplateParam={“name”:”Tom”,”code”:”123”} </td> 
 </tr> 
 <tr> 
 <td style="background-color:#ffffff;width:51.55pt;"> isv.BUSINESS_LIMIT_CONTROL </td> 
 <td style="background-color:#ffffff;width:122.85pt;"> 业务限流 </td> 
 <td style="background-color:#ffffff;width:276.35pt;"> 将短信发送频率限制在正常的业务流控范围内，默认流控：短信验证码 ：使用同一个签名，对同一个手机号码发送短信验证码，支持1条/分钟，5条/小时 ，累计10条/天。 </td> 
 </tr> 
 <tr> 
 <td style="background-color:#ffffff;width:51.55pt;"> isv.INVALID_JSON_PARAM </td> 
 <td style="background-color:#ffffff;width:122.85pt;"> JSON参数不合法，只接受字符串值 </td> 
 <td style="background-color:#ffffff;width:276.35pt;"> TemplateParam入参以Json格式字符串形式传入。例：正确{“code”:”123”} </td> 
 </tr> 
 <tr> 
 <td style="background-color:#ffffff;width:51.55pt;"> isv.BLACK_KEY_CONTROL_LIMIT </td> 
 <td style="background-color:#ffffff;width:122.85pt;"> 黑名单管控 </td> 
 <td style="background-color:#ffffff;width:276.35pt;"> 黑名单管控是指变量内容含有限制发送的内容，变量不支持透传url，同时检查通过变量是否透传了一些敏感信息触发关键字 </td> 
 </tr> 
 <tr> 
 <td style="background-color:#ffffff;width:51.55pt;"> isv.PARAM_LENGTH_LIMIT </td> 
 <td style="background-color:#ffffff;width:122.85pt;"> 参数超出长度限制 </td> 
 <td style="background-color:#ffffff;width:276.35pt;"> 单个变量长度限制在20字符内。 </td> 
 </tr> 
 <tr> 
 <td style="background-color:#ffffff;width:51.55pt;"> isv.PARAM_NOT_SUPPORT_URL </td> 
 <td style="background-color:#ffffff;width:122.85pt;"> 不支持URL </td> 
 <td style="background-color:#ffffff;width:276.35pt;"> 变量不支持透传url，同时检查通过变量是否透传了一些敏感信息触发关键字 </td> 
 </tr> 
 <tr> 
 <td style="background-color:#ffffff;width:51.55pt;"> isv.AMOUNT_NOT_ENOUGH </td> 
 <td style="background-color:#ffffff;width:122.85pt;"> 账户余额不足 </td> 
 <td style="background-color:#ffffff;width:276.35pt;"> 转入金额不足以发送当前信息，确保余额足够发送当前短信 </td> 
 </tr> 
 <tr> 
 <td style="background-color:#ffffff;width:51.55pt;"> isv.TEMPLATE_PARAMS_ILLEGAL </td> 
 <td style="background-color:#ffffff;width:122.85pt;"> 模板变量里包含非法关键字 </td> 
 <td style="background-color:#ffffff;width:276.35pt;"> 变量不支持透传url，同时检查通过变量是否透传了一些敏感信息触发关键字 </td> 
 </tr> 
 <tr> 
 <td style="background-color:#ffffff;width:51.55pt;"> SignatureDoesNotMatch </td> 
 <td style="background-color:#ffffff;width:122.85pt;"> Specified signature is not matched with our calculation. </td> 
 <td style="background-color:#ffffff;width:276.35pt;"> Signature加密错误，如为SDK调用，则需要注意accessKeyId和accessKeySecret字符串赋值正确无误；如自行加密的Signature，则需要检查加密逻辑，对照文档：<a href="https://help.aliyun.com/document_detail/56189.html" rel="nofollow">https://help.aliyun.com/document_detail/56189.html</a> </td> 
 </tr> 
 <tr> 
 <td style="background-color:#ffffff;width:51.55pt;"> InvalidTimeStamp.Expired </td> 
 <td style="background-color:#ffffff;width:122.85pt;"> Specified time stamp or date value is expired. </td> 
 <td style="background-color:#ffffff;width:276.35pt;"> 时间戳错误，发出请求的时间和服务器接收到请求的时间不在15分钟内。经常出现该错误的原因是时区原因造成的,目前网关使用的时间是GMT时间 </td> 
 </tr> 
 <tr> 
 <td style="background-color:#ffffff;width:51.55pt;"> SignatureNonceUsed </td> 
 <td style="background-color:#ffffff;width:122.85pt;"> Specified signature nonce was used already. </td> 
 <td style="background-color:#ffffff;width:276.35pt;"> 唯一随机数重复，SignatureNonce为唯一随机数，用于防止网络重放攻击。不同请求间要使用不同的随机数值。 </td> 
 </tr> 
 <tr> 
 <td style="background-color:#ffffff;width:51.55pt;"> InvalidVersion </td> 
 <td style="background-color:#ffffff;width:122.85pt;"> Specified parameter Version is not valid. </td> 
 <td style="background-color:#ffffff;width:276.35pt;"> 版本号错误，需要确认接口的版本号，如云通信短信、语音、流量服务的Version=2017-05-25 </td> 
 </tr> 
 <tr> 
 <td style="background-color:#ffffff;width:51.55pt;"> InvalidAction.NotFound </td> 
 <td style="background-color:#ffffff;width:122.85pt;"> Specified api is not found, please check your url and method </td> 
 <td style="background-color:#ffffff;width:276.35pt;"> 接口名错误，需要确认接口地址和接口名，如云通信短信服务短信发送：dysmsapi.aliyuncs.com，接口名Action=SendSms </td> 
 </tr> 
 </tbody> 
</table>

# **六、阿里云短信接入及注意事项** #

一、web项目

这种方式比较容易，直接把包导入项目中就行了，

*  maven配置

maven方式虽然也不难，但是不知怎么的掉坑好久，就是出不来了，就好像1+1不等于2似的，先来依赖

按理来说可以了，不过

<groupId>com.aliyun.mtgg</groupId>

<artifactId>aliyun-java-sdk-dysmsapi</artifactId>

这个包说什么也依赖不上，1.0.0一直是红色，就开始解决，原来下载不下来，只能手动打包到maven库

把这个jar包放在d盘根目录就行，然后手动打包：

mvn install:install-file -Dfile=d:\\aliyun-java-sdk-dysmsapi-1.0.0.jar -DgroupId=com.aliyun -DartifactId=aliyun-java-sdk-dysmsapi-1.0.0  -Dversion=1.0.0 -Dpackaging=jar

**附件一：**

**源码**

*  **常量类（**StaticPeram.java**）**

**package** com.yang.chen.zichen.util;

**public** **class** StaticPeram \{

/\*\*

\* 手机验证部分配置

\*/

// 设置超时时间-可自行调整

**public** **final** **static** String ***defaultConnectTimeout***  = "sun.net.client.defaultConnectTimeout";

**public** **final** **static** String ***defaultReadTimeout*** = "sun.net.client.defaultReadTimeout";

**public** **final** **static** String ***Timeout*** = "10000";

// 初始化ascClient需要的几个参数

**public** **final** **static** String ***product*** = "Dysmsapi";// 短信API产品名称（短信产品名固定，无需修改）

**public** **final** **static** String ***domain*** = "dysmsapi.aliyuncs.com";// 短信API产品域名（接口地址固定，无需修改）

// 替换成你的AK (产品密)

**public** **final** **static** String ***accessKeyId*** = "LTAIa10SHaX7xwr4";// 你的accessKeyId,填你自己的 上文配置所得  自行配置

**public** **final** **static** String ***accessKeySecret*** = "EDExcnuqGzaVOcOgJbeRYKaTOqNqSk";// 你的accessKeySecret,填你自己的 上文配置所得 自行配置

// 必填:短信签名-可在短信控制台中找到

**public** **final** **static** String ***SignName*** = "EDU教育云平台";    // 阿里云配置你自己的短信签名填入

// 必填:短信模板-可在短信控制台中找到

**public** **final** **static** String ***TemplateCode*** = "SMS\_144455919"; // 阿里云配置你自己的短信模板填入

*  **测试类（****Textdemo.Java****）**

**package com.yang.chen.zichen.echo;**

**import java.text.SimpleDateFormat;**

**import java.util.Arrays;**

**import java.util.Collections;**

**import java.util.Date;**

**import java.util.List;**

**import org.apache.struts2.ServletActionContext;**

**import com.aliyuncs.DefaultAcsClient;**

**import com.aliyuncs.IAcsClient;**

**import com.aliyuncs.dysmsapi.model.v20170525.QuerySendDetailsRequest;**

**import com.aliyuncs.dysmsapi.model.v20170525.QuerySendDetailsResponse;**

**import com.aliyuncs.dysmsapi.model.v20170525.SendSmsRequest;**

**import com.aliyuncs.dysmsapi.model.v20170525.SendSmsResponse;**

**import com.aliyuncs.exceptions.ClientException;**

**import com.aliyuncs.exceptions.ServerException;**

**import com.aliyuncs.profile.DefaultProfile;**

**import com.aliyuncs.profile.IClientProfile;**

**import com.yang.chen.zichen.util.StaticPeram;**

**public class Textdemo \{**

**// 产品名称:云通信短信API产品,开发者无需替换**

**static final String product = StaticPeram.product;**

**// 产品域名,开发者无需替换**

**static final String domain = StaticPeram.domain;**

**// TODO 此处需要替换成开发者自己的AK(在阿里云访问控制台寻找)，下面举个例子**

**static final String accessKeyId = StaticPeram.accessKeyId;**

**static final String accessKeySecret = StaticPeram.accessKeySecret;**

**public static SendSmsResponse sendSms() throws ClientException \{**

**// 可自助调整超时时间**

**System.setProperty(StaticPeram.defaultConnectTimeout, StaticPeram.Timeout);**

**System.setProperty(StaticPeram.defaultReadTimeout, StaticPeram.Timeout);**

**// 初始化acsClient,暂不支持region化**

**IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou", accessKeyId, accessKeySecret);**

**DefaultProfile.addEndpoint("cn-hangzhou", "cn-hangzhou", product, domain);**

**IAcsClient acsClient = new DefaultAcsClient(profile);**

**// 组装请求对象-具体描述见控制台-文档部分内容**

**SendSmsRequest request = new SendSmsRequest();**

**// 必填:待发送手机号**

**request.setPhoneNumbers("18729273677");**

**// 必填:短信签名-可在短信控制台中找到举个例子**

**request.setSignName(StaticPeram.SignName);**

**// 必填:短信模板id-可在短信控制台中找到，是id不是名字，举个例子**

**request.setTemplateCode(StaticPeram.TemplateCode);**

**// 生成短信验证码**

**String randomCode = verificationCode(6);**

**//将短信验证码保存到session中**

**//ServletActionContext.getRequest().getSession().setAttribute("TelephoneNumber", randomCode);**

**// 可选:模板中的变量替换JSON串,如模板内容为"亲爱的$\{name\},您的验证码为$\{code\}"时,此处的值为--必填，与模板相对应**

**// request.setTemplateParam("\{\\"name\\":\\"Tom\\", \\"code\\":\\"123\\"\}");**

**request.setTemplateParam("\{\\"code\\":" +randomCode+ "\}");**

**// 选填-上行短信扩展码(无特殊需求用户请忽略此字段)**

**// request.setSmsUpExtendCode("90997");**

**// 可选:outId为提供给业务方扩展字段,最终在短信回执消息中将此值带回给调用者**

**// request.setOutId("yourOutId");**

**// hint 此处可能会抛出异常，注意catch**

**SendSmsResponse sendSmsResponse = acsClient.getAcsResponse(request);**

**return sendSmsResponse;**

**\}**

**// 生成手机验证码（num位随机数）**

**private static String verificationCode(int num) \{**

**String\[\] beforeShuffle = new String\[\] \{ "1", "2", "3", "4", "5", "6", "7", "8", "9", "0" \};**

**List<String> list = Arrays.asList(beforeShuffle); // 将数组转成List**

**Collections.shuffle(list);**

**StringBuilder sb = new StringBuilder();**

**for (int i = 0; i < list.size(); i++) \{**

**sb.append(list.get(i));**

**\}**

**String afterShuffle = sb.toString();**

**String result = afterShuffle.substring(1, ++num);**

**return result;**

**\}**

**public static QuerySendDetailsResponse querySendDetails(String bizId) throws ServerException, ClientException \{**

**// 可自助调整超时时间**

**System.setProperty("sun.net.client.defaultConnectTimeout", "60000");**

**System.setProperty("sun.net.client.defaultReadTimeout", "60000");**

**// 初始化acsClient,暂不支持region化**

**IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou", StaticPeram.accessKeyId, StaticPeram.accessKeySecret);**

**DefaultProfile.addEndpoint("cn-hangzhou", "cn-hangzhou", product, domain);**

**IAcsClient acsClient = new DefaultAcsClient(profile);**

**// 组装请求对象**

**QuerySendDetailsRequest request = new QuerySendDetailsRequest();**

**// 必填-号码**

**request.setPhoneNumber("18729273677");**

**// 可选-流水号**

**request.setBizId(bizId);**

**// 必填-发送日期 支持30天内记录查询，格式yyyyMMdd**

**SimpleDateFormat ft = new SimpleDateFormat("yyyyMMdd");**

**request.setSendDate(ft.format(new Date()));**

**// 必填-页大小**

**request.setPageSize(10L);**

**// 必填-当前页码从1开始计数**

**request.setCurrentPage(1L);**

**// hint 此处可能会抛出异常，注意catch**

**QuerySendDetailsResponse querySendDetailsResponse = acsClient.getAcsResponse(request);**

**return querySendDetailsResponse;**

**\}**

**//属性驱动接收页面填写的验证码**

**    private String checkCode;**

**    public void setCheckCode(String checkCode) \{**

**        this.checkCode = checkCode;**

**    \}**

**    **

**    //手机验证码校验**

**    public String regist()\{**

**        //先校验短信验证码，如果不通过就跳回登录页面**

**        //从session中获取之前生成的短信验证码**

**        String checkcodeSession = (String) ServletActionContext.getRequest().getAttribute("TelephoneNumber");**

**        if(checkcodeSession==null||!checkcodeSession.equals(checkCode))\{**

**            System.out.println("短信验证码错误！");**

**            //短信验证码错误**

**            return "error";**

**        \}**

**        //调用webservice连接crm保存客户信息**

**        System.out.println("客户注册成功...");**

**        return "success";**

**    \}**

**public static void main(String\[\] args) throws ClientException, InterruptedException \{**

**// 发短信**

**SendSmsResponse response = sendSms();**

**//线程等待3秒**

**Thread.sleep(3000L);**

**// 查明细**

**if (response.getCode() != null && response.getCode().equals("OK")) \{**

**System.out.println("请求成功");**

**QuerySendDetailsResponse querySendDetailsResponse = querySendDetails(response.getBizId());**

**System.out.println("短信明细查询接口返回数据----------------");**

**System.out.println("Code=" + querySendDetailsResponse.getCode());**

**System.out.println("Message=" + querySendDetailsResponse.getMessage());**

**int i = 0;**

**for (QuerySendDetailsResponse.SmsSendDetailDTO smsSendDetailDTO : querySendDetailsResponse**

**.getSmsSendDetailDTOs()) \{**

**System.out.println("SmsSendDetailDTO\[" + i + "\]:");**

**System.out.println("Content=" + smsSendDetailDTO.getContent());**

**System.out.println("ErrCode=" + smsSendDetailDTO.getErrCode());**

**System.out.println("OutId=" + smsSendDetailDTO.getOutId());**

**System.out.println("PhoneNum=" + smsSendDetailDTO.getPhoneNum());**

**System.out.println("ReceiveDate=" + smsSendDetailDTO.getReceiveDate());**

**System.out.println("SendStatus=" + smsSendDetailDTO.getSendStatus());**

**System.out.println("Template=" + smsSendDetailDTO.getTemplateCode());**

**\}**

**System.out.println("TotalCount=" + querySendDetailsResponse.getTotalCount());**

**System.out.println("RequestId=" + querySendDetailsResponse.getRequestId());**

**\}**

[Link 1]: http://electronics.bowenwang.com.cn/pc.htm
[Link 2]: http://electronics.bowenwang.com.cn/cell-phone.htm
[Link 3]: https://account.aliyun.com/register/register.htm?spm=5176.1879423.631162.1.AXepAe
[AccessKey]: https://help.aliyun.com/document_detail/53045.html?spm=5176.doc55322.6.593.aj9nEB&parentId=44282
[Link 4]: https://help.aliyun.com/document_detail/55322.html?spm=5176.doc55764.6.579.UlcBpe
[Link 5]: https://help.aliyun.com/document_detail/55324.html?spm=5176.doc55491.6.573.QG9eiy
[Link 6]: https://help.aliyun.com/document_detail/55327.html?spm=5176.doc55324.6.543.kDzHEo
[Link 7]: https://help.aliyun.com/document_detail/55330.html?spm=5176.doc55327.6.544.n6Z8cO
[Link 8]: https://help.aliyun.com/document_detail/44357.html?spm=5176.doc55330.6.547.XCmj9s
[Link 9]: https://help.aliyun.com/document_detail/55764.html?spm=5176.doc55325.6.548.BcImjx
[API]: https://help.aliyun.com/document_detail/54229.html?spm=5176.product44282.6.594.0qtorv&parentId=44282
[SDK_DEMO]: https://help.aliyun.com/document_detail/55359.html?spm=5176.product44282.6.569.8GCxq9
[-JAVA]: https://help.aliyun.com/document_detail/55284.html?spm=5176.doc55491.6.552.JjHK5m
[-PHP]: https://help.aliyun.com/document_detail/55451.html?spm=5176.doc55284.6.556.yMZ2BW
[-Python]: https://help.aliyun.com/document_detail/55491.html?spm=5176.doc55451.6.560.lyz7Tx
[Node.js]: https://help.aliyun.com/document_detail/57458.html?spm=5176.doc56189.6.564.TQrZgk