java + maven +榛子云短信 实现发送短信验证码功能

460 阅读2分钟

如何使用java + maven的项目环境发送短信验证码,本文使用的是榛子云短信 的接口。

1. 安装sdk

下载地址: smsow.zhenzikj.com/doc/sdk.htm…

下载下来是jar文件,需要将jar发布到本地的maven仓库中, 在cmd环境下输入:

mvn install:install-file -DgroupId=com.zhenzi -DartifactId=sms -Dversion=1.0.0 -Dpackaging=jar -Dfile=/Users/Downloads/ZhenziSmsSDK.jar

注意:-Dfile是你本地下载的jar文件的路径,本例中使用的mac系统

接下来在pom.xml中引入项目:

<dependency>	 <groupId>com.zhenzi</groupId>	 <artifactId>sms</artifactId>	 <version>1.0.0</version></dependency>

ok, sdk安装完毕,其实也挺简单的

2. 申请测试账号,获取appId、appSecret

测试账号需要人工申请,一般几分钟就可以申请下来。

使用测试账号登录管理后台获取appId、appSecret, 地址: sms.zhenzikj.com/zhenzisms_u…


在"我的应用"->"详情"中打开:


3.用法

使用事先申请的AppId、AppSecret初始化ZhenziSmsClient:

ZhenziSmsClient client = new ZhenziSmsClient(appId, appSecret);

AppId、AppSecret是短信平台分配的

1)发送短信

String result = client.send("15811111111", "您的验证码为4534,有效时间为5分钟");

send方法用于单条发送短信

参数1:接收者手机号码,参数2:短信内容

返回结果是json格式的字符串, code: 发送状态,0为成功。非0为发送失败,可从data中查看错误信息

			{			    "code":0,			    "data":"发送成功"			}

错误代码表

错误码原因解决方案
100参数格式错误检查请求参数是否为空, 或手机号码格式错误
101短信内容超过1000字短信内容过长,请筛检或分多次发送
105appId错误或应用不存在请联系工作人员申请应用或检查appId是否输入错误
106应用被禁止请联系工作人员查看原因
107ip错误如果设置了ip白名单,系统会检查请求服务器的ip地址,已确定是否为安全的来源访问
108短信余额不足需要到用户中心进行充值
109今日发送超过限额如果设置了日发送数量,则每个接收号码不得超过这个数量
110应用秘钥(AppSecret)错误检查AppSecret是否输入错误,或是否已在用户中心进行了秘钥重置
111账号不存在请联系工作人员申请账号
1000系统位置错误请联系工作人员或技术人员检查原因