如何使用java + maven的项目环境发送短信验证码,本文使用的是榛子云短信的接口。
1. 安装sdk
下载地址:http://smsow.zhenzikj.com/doc/sdk.html
下载下来是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中引入项目:
ok, sdk安装完毕,其实也挺简单的
2. 申请测试账号,获取appId、appSecret
测试账号需要人工申请,一般几分钟就可以申请下来。
使用测试账号登录管理后台获取appId、appSecret, 地址:http://sms.zhenzikj.com/zhenzisms_user
在"我的应用"->"详情"中打开:
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系统位置错误请联系工作人员或技术人员检查原因